Process.finalization - process - Node

property Process.finalization

Usage in Deno

import { type Process } from "node:process";

Methods



register<T extends object>(ref: T,
callback: (ref: T,
event: "exit",
) => void,
): void

This function registers a callback to be called when the process emits the exit event if the ref object was not garbage collected. If the object ref was garbage collected before the exit event is emitted, the callback will be removed from the finalization registry, and it will not be called on process exit.

Inside the callback you can release the resources allocated by the ref object. Be aware that all limitations applied to the beforeExit event are also applied to the callback function, this means that there is a possibility that the callback will not be called under special circumstances.

The idea of this function is to help you free up resources when the starts process exiting, but also let the object be garbage collected if it is no longer being used.



registerBeforeExit<T extends object>(ref: T,
callback: (ref: T,
event: "beforeExit",
) => void,
): void

This function behaves exactly like the register, except that the callback will be called when the process emits the beforeExit event if ref object was not garbage collected.

Be aware that all limitations applied to the beforeExit event are also applied to the callback function, this means that there is a possibility that the callback will not be called under special circumstances.



unregister(ref: object): void

This function remove the register of the object from the finalization registry, so the callback will not be called anymore.