ECMA-262 · 18^inci Baskı

Bellek Yönetimi (Managing Memory)

26.1 WeakRef Nesneleri (WeakRef Objects)

Bir WeakRef, hedef nesneyi veya sembolü çöp toplamadan (garbage collection) korumaksızın ona başvurmak için kullanılan bir nesnedir. WeakRef nesneleri, eğer hedef çöp toplama tarafından geri kazanılmamışsa, hedef değere erişim sağlamak üzere çözümlenebilir (dereferenced).

26.1.1 WeakRef Yapıcısı (The WeakRef Constructor)

WeakRef yapıcısı (constructor):

%WeakRef% nesnesidir.
global nesnenin (global object) "WeakRef" özelliğinin ilk değeridir.
bir yapıcı (constructor) olarak çağrıldığında yeni bir WeakRef oluşturur ve başlatır.
fonksiyon olarak çağrılması amaçlanmamıştır ve bu şekilde çağrıldığında bir istisna fırlatır.
bir sınıf tanımının extends ifadesinin değeri olarak kullanılabilir. Belirtilen WeakRef davranışını miras almayı amaçlayan alt sınıf yapıcıları (constructors), alt sınıf örneğini WeakRef.prototype yerleşik metotlarını desteklemek için gerekli dahili durumla oluşturmak ve başlatmak için WeakRef yapıcısına (constructor) bir super çağrısı içermelidir.

26.1.1.1 WeakRef ( target )

Bu fonksiyon çağrıldığında aşağıdaki adımları gerçekleştirir:

Eğer NewTarget undefined ise, bir TypeError istisnası fırlat.
Eğer CanBeHeldWeakly(target) false ise, bir TypeError istisnası fırlat.
weakRef, ? OrdinaryCreateFromConstructor(NewTarget, "%WeakRef.prototype%", « [[WeakRefTarget]] ») olsun.
AddToKeptObjects(target) işlemini gerçekleştir.
weakRef.[[WeakRefTarget]] değerini target olarak ayarla.
weakRef döndür.

26.1.2 WeakRef Yapıcısının Özellikleri (Properties of the WeakRef Constructor)

WeakRef yapıcısı (constructor):

değeri %Function.prototype% olan bir [[Prototype]] dahili yuvasına sahiptir.
aşağıdaki özelliklere sahiptir:

26.1.2.1 WeakRef.prototype

WeakRef.prototype özelliğinin ilk değeri WeakRef prototip nesnesidir (WeakRef prototype object).

Bu özellik { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } özniteliklerine sahiptir.

26.1.3 WeakRef Prototip Nesnesinin Özellikleri (Properties of the WeakRef Prototype Object)

WeakRef prototip nesnesi:

%WeakRef.prototype% nesnesidir.
değeri %Object.prototype% olan bir [[Prototype]] dahili yuvasına sahiptir.
bir sıradan nesnedir (ordinary object).
bir [[WeakRefTarget]] dahili yuvasına sahip değildir.

Kuralsal İsteğe Bağlı (Normative Optional)

26.1.3.1 WeakRef.prototype.constructor

WeakRef.prototype.constructor özelliğinin ilk değeri %WeakRef% yapıcısıdır.

26.1.3.2 WeakRef.prototype.deref ( )

Bu metot çağrıldığında aşağıdaki adımları gerçekleştirir:

weakRef, this değeri olsun.
? RequireInternalSlot(weakRef, [[WeakRefTarget]]) işlemini gerçekleştir.
WeakRefDeref(weakRef) döndür.

NOT

Eğer WeakRef undefined olmayan bir target değeri döndürürse, o zaman bu target değeri geçerli ECMAScript kodunun yürütülmesi tamamlanana kadar çöp toplama (garbage collection) işlemine tabi tutulmamalıdır. AddToKeptObjects işlemi okuma tutarlılığının korunmasını sağlar.

let target = { foo() {} };
let weakRef = new WeakRef(target);

// ... daha sonra ... if (weakRef.deref()) {
  weakRef.deref().foo();
}

Yukarıdaki örnekte, eğer ilk deref çağrısı undefined olarak değerlendirilmezse ikinci deref çağrısı da undefined olamaz.

26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag%(07_sec-ecmascript-data-types-and-values.md#sec-well-known-symbols) özelliğinin ilk değeri "WeakRef" dizgisidir.

Bu özellik { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } özniteliklerine sahiptir.

26.1.4 WeakRef Soyut İşlemleri (WeakRef Abstract Operations)

26.1.4.1 WeakRefDeref ( weakRef )

WeakRefDeref soyut işlemi, weakRef (bir WeakRef) argümanını alır ve bir ECMAScript dil değeri (ECMAScript language value) döndürür. Çağrıldığında aşağıdaki adımları gerçekleştirir:

target, weakRef.[[WeakRefTarget]] olsun.
Eğer target empty değilse, o zaman
1. AddToKeptObjects(target) işlemini gerçekleştir.
2. target döndür.
undefined döndür.

26.1.5 WeakRef Örneklerinin Özellikleri (Properties of WeakRef Instances)

WeakRef örnekleri, WeakRef prototip nesnesinden (WeakRef prototype object) özellikleri miras alan sıradan nesnelerdir (ordinary objects). WeakRef örnekleri ayrıca bir [[WeakRefTarget]] dahili yuvasına sahiptir.

26.2 FinalizationRegistry Nesneleri (FinalizationRegistry Objects)

Bir FinalizationRegistry, hedef nesneler ve semboller çöp toplama (garbage collection) işlemine tabi tutulduğunda gerçekleştirilen temizleme işlemlerinin kaydedilmesini ve kaydının silinmesini yöneten bir nesnedir.

26.2.1 FinalizationRegistry Yapıcısı (The FinalizationRegistry Constructor)

FinalizationRegistry yapıcısı (constructor):

%FinalizationRegistry% nesnesidir.
global nesnenin (global object) "FinalizationRegistry" özelliğinin ilk değeridir.
bir yapıcı (constructor) olarak çağrıldığında yeni bir FinalizationRegistry oluşturur ve başlatır.
fonksiyon olarak çağrılması amaçlanmamıştır ve bu şekilde çağrıldığında bir istisna fırlatır.
bir sınıf tanımının extends ifadesinin değeri olarak kullanılabilir. Belirtilen FinalizationRegistry davranışını miras almayı amaçlayan alt sınıf yapıcıları (constructors), alt sınıf örneğini FinalizationRegistry.prototype yerleşik metotlarını desteklemek için gerekli dahili durumla oluşturmak ve başlatmak için FinalizationRegistry yapıcısına (constructor) bir super çağrısı içermelidir.

26.2.1.1 FinalizationRegistry ( cleanupCallback )

Bu fonksiyon çağrıldığında aşağıdaki adımları gerçekleştirir:

Eğer NewTarget undefined ise, bir TypeError istisnası fırlat.
Eğer IsCallable(cleanupCallback) false ise, bir TypeError istisnası fırlat.
finalizationRegistry, ? OrdinaryCreateFromConstructor(NewTarget, "%FinalizationRegistry.prototype%", « [[Realm]], [[CleanupCallback]], [[Cells]] ») olsun.
func, etkin fonksiyon nesnesi (active function object) olsun.
finalizationRegistry.[[Realm]] değerini func.[[Realm]] olarak ayarla.
finalizationRegistry.[[CleanupCallback]] değerini HostMakeJobCallback(cleanupCallback) olarak ayarla.
finalizationRegistry.[[Cells]] değerini yeni ve boş bir Liste (List) olarak ayarla.
finalizationRegistry döndür.

26.2.2 FinalizationRegistry Yapıcısının Özellikleri (Properties of the FinalizationRegistry Constructor)

FinalizationRegistry yapıcısı (constructor):

değeri %Function.prototype% olan bir [[Prototype]] dahili yuvasına sahiptir.
aşağıdaki özelliklere sahiptir:

26.2.2.1 FinalizationRegistry.prototype

FinalizationRegistry.prototype özelliğinin ilk değeri FinalizationRegistry prototip nesnesidir (FinalizationRegistry prototype object).

Bu özellik { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } özniteliklerine sahiptir.

26.2.3 FinalizationRegistry Prototip Nesnesinin Özellikleri (Properties of the FinalizationRegistry Prototype Object)

FinalizationRegistry prototip nesnesi:

%FinalizationRegistry.prototype% nesnesidir.
değeri %Object.prototype% olan bir [[Prototype]] dahili yuvasına sahiptir.
bir sıradan nesnedir (ordinary object).
[[Cells]] ve [[CleanupCallback]] dahili yuvalarına sahip değildir.

26.2.3.1 FinalizationRegistry.prototype.constructor

FinalizationRegistry.prototype.constructor özelliğinin ilk değeri %FinalizationRegistry% yapıcısıdır.

26.2.3.2 FinalizationRegistry.prototype.register ( target, heldValue [ , unregisterToken ] )

Bu metot çağrıldığında aşağıdaki adımları gerçekleştirir:

finalizationRegistry, this değeri olsun.
? RequireInternalSlot(finalizationRegistry, [[Cells]]) işlemini gerçekleştir.
Eğer CanBeHeldWeakly(target) false ise, bir TypeError istisnası fırlat.
Eğer SameValue(target, heldValue) true ise, bir TypeError istisnası fırlat.
Eğer CanBeHeldWeakly(unregisterToken) false ise, o zaman
1. Eğer unregisterToken undefined değilse, bir TypeError istisnası fırlat.
2. unregisterToken değerini empty olarak ayarla.
cell, { [[WeakRefTarget]]: target, [[HeldValue]]: heldValue, [[UnregisterToken]]: unregisterToken } Kaydı (Record) olsun.
cell kaydını finalizationRegistry.[[Cells]] listesine ekle.
undefined döndür.

26.2.3.3 FinalizationRegistry.prototype.unregister ( unregisterToken )

Bu metot çağrıldığında aşağıdaki adımları gerçekleştirir:

finalizationRegistry, this değeri olsun.
? RequireInternalSlot(finalizationRegistry, [[Cells]]) işlemini gerçekleştir.
Eğer CanBeHeldWeakly(unregisterToken) false ise, bir TypeError istisnası fırlat.
removed, false olsun.
finalizationRegistry.[[Cells]] listesindeki her bir { [[WeakRefTarget]], [[HeldValue]], [[UnregisterToken]] } cell Kaydı (Record) için sırayla yap:
1. Eğer cell.[[UnregisterToken]] empty değilse ve SameValue(cell.[[UnregisterToken]], unregisterToken) true ise, o zaman
  1. cell kaydını finalizationRegistry.[[Cells]] listesinden çıkar.
  2. removed değerini true olarak ayarla.
removed döndür.

26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag%(07_sec-ecmascript-data-types-and-values.md#sec-well-known-symbols) özelliğinin ilk değeri "FinalizationRegistry" dizgisidir.

Bu özellik { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } özniteliklerine sahiptir.

26.2.4 FinalizationRegistry Örneklerinin Özellikleri (Properties of FinalizationRegistry Instances)

FinalizationRegistry örnekleri, FinalizationRegistry prototip nesnesinden (FinalizationRegistry prototype object) özellikleri miras alan sıradan nesnelerdir (ordinary objects). FinalizationRegistry örnekleri ayrıca [[Cells]] ve [[CleanupCallback]] dahili yuvalarına sahiptir.

#26.1 WeakRef Nesneleri (WeakRef Objects)

#26.1.1 WeakRef Yapıcısı (The WeakRef Constructor)

#26.1.1.1 WeakRef ( target )

#26.1.2 WeakRef Yapıcısının Özellikleri (Properties of the WeakRef Constructor)

#26.1.2.1 WeakRef.prototype

#26.1.3 WeakRef Prototip Nesnesinin Özellikleri (Properties of the WeakRef Prototype Object)

#26.1.3.1 WeakRef.prototype.constructor

#26.1.3.2 WeakRef.prototype.deref ( )

#26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]

#26.1.4 WeakRef Soyut İşlemleri (WeakRef Abstract Operations)

#26.1.4.1 WeakRefDeref ( weakRef )

#26.1.5 WeakRef Örneklerinin Özellikleri (Properties of WeakRef Instances)

#26.2 FinalizationRegistry Nesneleri (FinalizationRegistry Objects)

#26.2.1 FinalizationRegistry Yapıcısı (The FinalizationRegistry Constructor)

#26.2.1.1 FinalizationRegistry ( cleanupCallback )

#26.2.2 FinalizationRegistry Yapıcısının Özellikleri (Properties of the FinalizationRegistry Constructor)

#26.2.2.1 FinalizationRegistry.prototype

#26.2.3 FinalizationRegistry Prototip Nesnesinin Özellikleri (Properties of the FinalizationRegistry Prototype Object)

#26.2.3.1 FinalizationRegistry.prototype.constructor

#26.2.3.2 FinalizationRegistry.prototype.register ( target, heldValue [ , unregisterToken ] )

#26.2.3.3 FinalizationRegistry.prototype.unregister ( unregisterToken )

#26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]

#26.2.4 FinalizationRegistry Örneklerinin Özellikleri (Properties of FinalizationRegistry Instances)

26.1 WeakRef Nesneleri (WeakRef Objects)

26.1.1 WeakRef Yapıcısı (The WeakRef Constructor)

26.1.1.1 WeakRef ( target )

26.1.2 WeakRef Yapıcısının Özellikleri (Properties of the WeakRef Constructor)

26.1.2.1 WeakRef.prototype

26.1.3 WeakRef Prototip Nesnesinin Özellikleri (Properties of the WeakRef Prototype Object)

26.1.3.1 WeakRef.prototype.constructor

26.1.3.2 WeakRef.prototype.deref ( )

26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]

26.1.4 WeakRef Soyut İşlemleri (WeakRef Abstract Operations)

26.1.4.1 WeakRefDeref ( weakRef )

26.1.5 WeakRef Örneklerinin Özellikleri (Properties of WeakRef Instances)

26.2 FinalizationRegistry Nesneleri (FinalizationRegistry Objects)

26.2.1 FinalizationRegistry Yapıcısı (The FinalizationRegistry Constructor)

26.2.1.1 FinalizationRegistry ( cleanupCallback )

26.2.2 FinalizationRegistry Yapıcısının Özellikleri (Properties of the FinalizationRegistry Constructor)

26.2.2.1 FinalizationRegistry.prototype

26.2.3 FinalizationRegistry Prototip Nesnesinin Özellikleri (Properties of the FinalizationRegistry Prototype Object)

26.2.3.1 FinalizationRegistry.prototype.constructor

26.2.3.2 FinalizationRegistry.prototype.register ( target, heldValue [ , unregisterToken ] )

26.2.3.3 FinalizationRegistry.prototype.unregister ( unregisterToken )

26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]

26.2.4 FinalizationRegistry Örneklerinin Özellikleri (Properties of FinalizationRegistry Instances)