FinalizationRegistry

Объект, который управляет обработчиками событий, которые срабатывают, когда сборщик мусора собирает зарегистрированные в нём объекты. Это своеобразный реестр, в котором хранится всё, что нужно сделать с объектами перед их сборкой.

Колбэк очистки (cleanup callback) ещё называют финализатором (finalizer). Это такая функция, которая выполняется, когда зарегистрированный объект собирается сборщиком мусора.

Создаём регистр с колбэком heldValue:

        
          
          const registry = new FinalizationRegistry((heldValue) => {  // …})
          const registry = new FinalizationRegistry((heldValue) => {
  // …
})

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Чтобы создать FinalizationRegistry, обязательно используйте оператор new. В скобках в качестве аргумента указывают колбэк очистки.

        
          
          new FinalizationRegistry(anyCallbackFunction)
          new FinalizationRegistry(anyCallbackFunction)

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Старайтесь не полагаться на обработчики событий в объекте FinalizationRegistry. Сборка мусора — сложный процесс, и никто не знает, когда эти колбэки сработают и сработают ли вообще.

• .register() — регистрирует объект в реестре.
• .unregister() — отменяет регистрацию объекта в реестре.