Widely available すべての主要ブラウザで対応済み。安心して使用可能。
言語コア Widely available

Weak references

WeakRef はオブジェクトへの弱い参照を作成し、ガベージコレクションを妨げません。FinalizationRegistry でオブジェクトの回収時にクリーンアップ処理を実行できます。

言語コアES2021

概要

WeakRef はオブジェクトへの弱い参照を作成し、ガベージコレクションを妨げません。FinalizationRegistry でオブジェクトの回収時にクリーンアップ処理を実行できます。

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
FinalizationRegistry
84
84
79
14.1
84
14.5
FinalizationRegistry.FinalizationRegistry

FinalizationRegistry コンストラクターは、指定されたコールバックを使用する FinalizationRegistry オブジェクトを生成します。
84
84
79
14.1
84
14.5
FinalizationRegistry.register

register() メソッドはオブジェクトを FinalizationRegistry インスタンスへ登録し、オブジェクトがガベージコレクションで回収された場合、レジストリのコールバックが呼び出されるようになります。
84
84
79
14.1
84
14.5
FinalizationRegistry.register.symbol as target

未登録シンボルをターゲットとする
109
109
146
16.4
109
16.4
FinalizationRegistry.unregister

unregister は対象のオブジェクトを FinalizationRegistry インスタンスから登録解除します。
84
84
79
14.1
84
14.5
FinalizationRegistry.unregister.symbol as target

未登録シンボルをターゲットとする
109
109
16.4
109
16.4
その他
javascript.builtins.WeakRef

WeakRef オブジェクトは、ガベージコレクションを受けることを妨げない他のオブジェクトへの弱い参照を保持します。
84
84
79
14.1
84
14.5
ビルトインオブジェクト
WeakRef.WeakRef

WeakRef() コンストラクターは、 WeakRef オブジェクトを生成します。
84
84
79
14.1
84
14.5
WeakRef.WeakRef.symbol as target

未登録シンボルをターゲットとする
109
109
146
16.4
109
16.4
WeakRef.deref

deref() は WeakRef インスタンスのメソッドで、この WeakRef のターゲット値、またはその値が既にガベージコレクションされている場合は undefined を返します。
84
84
79
14.1
84
14.5
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT 
let target = { data: 'important' };
const ref = new WeakRef(target);

ref.deref(); // { data: 'important' }
target = null; // Becomes a candidate for garbage collection
// ref.deref(); // undefined (after garbage collection)

ライブデモ

Create and dereference a WeakRef

Wrap an object in WeakRef and inspect the current dereferenced value.

JavaScript
出力
「実行」ボタンを押してください

Use WeakRef in a cache

Keep a lightweight reference in a cache without forcing long-term retention.

JavaScript
出力
「実行」ボタンを押してください

Compare direct objects and WeakRef

See the difference between the original object and its weak reference wrapper.

JavaScript
出力
「実行」ボタンを押してください

実務での使いどころ

  • Weak references の活用

    オブジェクトへの弱い参照を保持する WeakRef と、クリーンアップコールバックの FinalizationRegistry。

注意点

  • 特になし。すべての主要ブラウザで安定して動作する。

アクセシビリティ

  • JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。

参考リンク

Powered by web-features