Che cos'è il "ownerID" in Immutable.js?

Question

Sto passando attraverso il codice sorgente di Immutable.js e c'è un campo ownerID che non capisco.

Ecco la fonte per Map.asMutable() e Map.asImmutable(): https://github.com/facebook/immutable-js/blob/master/src/Map.js#L171

Sembra che l'unica differenza tra un mutevole e un oggetto immutabile, sono i loro ownerID s. Che cos'è un ownerID e a cosa serve?

Answer 1

Se si traccia indietro la proprietà:

L # 14:

import { DELETE, SHIFT, SIZE, MASK, NOT_SET, CHANGE_LENGTH, DID_ALTER, OwnerID, 
      MakeRef, SetRef, arrCopy } from './TrieUtils' 

in src/TrieUtils.js:

L # 36:

// A function which returns a value representing an "owner" for transient writes 
// to tries. The return value will only ever equal itself, and will not equal 
// the return of any subsequent call of this function. 
export function OwnerID() {} 

Sono alcune proprietà che creano come hash per rappresentare un proprietario virtuale.

Answer 2

Dal source code:

// A function which returns a value representing an "owner" for transient writes 
// to tries. The return value will only ever equal itself, and will not equal 
// the return of any subsequent call of this function. 
function OwnerID() {} 

La mia comprensione di quanto sopra è che il campo this.__ownerID viene utilizzato per confrontare gli oggetti. Uno Map confrontato con se stesso avrà lo stesso ownerID, mentre un Map confrontato con un altro Map vedrà due diversi ownerID s.

È possibile vedere un esempio di questo uso un little farther down in the file in question:

__ensureOwner(ownerID) { 
    if (ownerID === this.__ownerID) { 
    return this; 
    } 
    if (!ownerID) { 
    this.__ownerID = ownerID; 
    this.__altered = false; 
    return this; 
    } 
    return makeMap(this.size, this._root, ownerID, this.__hash); 
} 

Infatti, searching the entire repo, vedrai che questa funzione è comune tra i tipi di dati, con ogni tipo con una versione leggermente modificata di tornare una nuova versione corretta di quel tipo.

Answer 3

Viene utilizzato per garantire la mutabilità in asMutable istanze restituite. Quando asMutable viene richiamato, assicuri __ownerId e restituisce l'istanza corrente posteriore -

asMutable() { 
    return this.__ownerID ? this : this.__ensureOwner(new OwnerID()); 
} 

Poi alcuna supported operazioni mutanti restituire l'istanza corrente posteriore, invece di creare una nuova istanza con le modifiche (che è la chiave per immutability) .

esempio, ecco come il metodo "clear" funziona basato sulla presenza di __ownerId -

clear() { 
    if (this.size === 0) { 
     return this; 
    } 
    if (this.__ownerID) { 
     this.size = 0; 
     this._root = null; 
     this.__hash = undefined; 
     this.__altered = true; 
     return this; 
    } 
    return emptyMap(); 
} 

noti che quando questo .__ ownerid è presente, il metodo restituisce l'istanza corrente (quindi mutando stesso) . Ma quando è assente, restituisce una nuova mappa per garantire l'immutabilità.