La funzione Symbol()
restituisce un valore di tipo symbol, dispone di proprietĂ statiche che espongono diversi membri di oggetti built-in, ha metodi statici che espongono il registro globale dei symbol, ed assomiglia all'oggetto built-in class, ma non dispone di un costruttore e non supporta la sintassi "new Symbol()
".
Ogni valore symbol restituito da Symbol()
è unico. Un valore symbol può essere utilizzato come identificatore per proprietà di un oggetto; questo è lo scopo di tale tipo di dati. Ulteriori spiegazioni circa il loro scopo ed uso può essere trovato nella pagina: glossary entry for Symbol.
Il tipo di dati symbol è un primitive data type.
Syntax
Symbol([description])
Parametri
description
Optional- Opzionale, string. Una descrizione del symbol che può essere usata per il debug ma non per accedere al symbol stesso.
Descrizione
Per creare un nuovo primitive symbol, scrivereSymbol()
con una stringa opzionale di descrizione:
var sym1 = Symbol();
var sym2 = Symbol('foo');
var sym3 = Symbol('foo');
Il codice sopra crea tre nuovi symbol. Notare che Symbol("foo")
non costringe la stringa "foo" in un symbol. Esso crea un nuovo symbol ogni volta:
Symbol('foo') === Symbol('foo'); // false
La sintassi seguente con l'operatore new
genererĂ un TypeError
:
var sym = new Symbol(); // TypeError
Questo previene gli autori dal creare un esplicito oggetto wrapper Symbol
invece di un nuovo valore symbol e la cosa può sorprendere in quanto creare un oggetto wrapper esplicito attorno ad un tipo di dati primitivo è generalmente possibile (ad esempio, new Boolean
, new String
e new Number
).
Se veramente si vuole creare un oggetto wrapper Symbol
si può usare la funzione Object()
:
var sym = Symbol('foo');
typeof sym; // "symbol"
var symObj = Object(sym);
typeof symObj; // "object"
Symbols condivisi nel registro globale dei symbol
La sintassi vista sopra che utilizza la funzione Symbol()
non crea un symbol globale che sarĂ disponibile nell'intero codebase. Per creare dei symbol disponibili attraverso diversi files ed anche attraverso diversi realms (ognuno dei quali ha il proprio global scope), usare i metodi Symbol.for()
e Symbol.keyFor()
per impostare e leggere i symbol dal registro globale.
Cercare le proprietĂ symbol negli oggetti
Il metodo Object.getOwnPropertySymbols()
restituisce un array di symbol e permette di trovare le proprietà symbol di un oggetto. Notare che ogni oggetto è inizializzato senza alcuna proprietà symbol, per cui l'array restituito sarà vuoto a meno che una proprietà symbol non sia stata creata sull'oggetto.
ProprietĂ
Symbol.length
- Proprietà "lunghezza", il cui valore è 0.
Symbol.prototype
- Rappresenta il prototype del costruttore
Symbol
.
Symbols ben noti
In aggiunta ai symbol definiti da voi, JavaScript dispone di alcuni symbol built-in che rappresentano alcuni comportamenti interni del linguaggio che non sono esposti agli sviluppatori in ECMAScript5 e precedenti. A tali symbol si può accedere tramite le seguenti proprietà :
Symbols di iterazione
Symbol.iterator
- Un metodo che restituisce l'iteratore di default per un oggetto. Usato da
for...of
. Symbol.asyncIterator
- Un metodo che restituisce l'iteratore asincrono di default per un oggetto. Usato da
for await of
.
Symbols per le espressioni regolari
Symbol.match
- Un metodo che effettua la corrispondenza su una stringa, usato anche per determinare se un oggetto può essere utilizzato come espressione regolare. Usato da
String.prototype.match()
. Symbol.replace
- Un metodo che sostituisce le sottostringhe di una stringa corrispondenti. Usato da
String.prototype.replace()
. Symbol.search
- Un metodo che restituisce l'indice all'interno di una stringa che corrisponde all'espressione regolare. Usato da
String.prototype.search()
. Symbol.split
- Un metodo che divide una stringa all'indice corrispondente ad una espressione regolare. Usato da
String.prototype.split()
.
Altri symbols
Symbol.hasInstance
- Un metodo che determina se un oggetto costruttore riconosce un oggetto come propria istanza. Usato da
instanceof
. Symbol.isConcatSpreadable
- Un valore booleano indicante se un oggetto deve essere appiattito ai soui elementi array. Usato da
Array.prototype.concat()
. Symbol.unscopables
- An object value of whose own and inherited property names are excluded from the
with
environment bindings of the associated object. Symbol.species
- Una funzione costruttore utilizzata per creare oggetti derivati.
Symbol.toPrimitive
- Un metodo che converte un oggetto in un valore primitivo.
Symbol.toStringTag
- Una stringa usata per la descizione di default di un oggetto. Usato da
Object.prototype.toString()
.
Metodi
Symbol.for(key)
- Cerca la "key" fornita tra i symbol esistenti e la restituisce nel caso in cui venga trovata. In caso contrario un nuovo symbol viene creato nel registro globale dei symbol con la "key" indicata.
Symbol.keyFor(sym)
- Trova una chiave symbol condivisa dal registro globale dei symbol per il symbol fornito.
Symbol prototype
Tutti i simboli ereditano da Symbol.prototype
.
ProprietĂ
Metodi
Esempi
Using the typeof operator with symbols
L'operatore typeof
può aiutare ad identificare i symbol.
typeof Symbol() === 'symbol'
typeof Symbol('foo') === 'symbol'
typeof Symbol.iterator === 'symbol'
Conversioni di tipo dei symbol
Alcune cose da notare quando si lavora con le conversioni di tipo dei symbol.
- Quando si prova a convertire un symbol in un numero, un
TypeError
verrĂ generato
(e.g.+sym
orsym | 0
). - Quando si usa l'uguaglianza non stretta,
Object(sym) == sym
restituiscetrue.
Symbol("foo") + "bar"
lancia unTypeError
(non si può convertire un symbol in stringa). Questo previene, ad esempio, la creazione silenziosa di un nuovo nome di proprietà stringa da un symbol.- La "safer"
String(sym)
conversion funziona come una chiamata aSymbol.prototype.toString()
con symbol, ma notare chenew String(sym)
genererĂ un errore.
Symbols ed iterazione for...in
I symbol non sono enumerabili in un'iterazione for...in
. In aggiunta, Object.getOwnPropertyNames()
non restituirĂ le proprietĂ symbol dell'oggetto, tuttavia, si puĂš usare Object.getOwnPropertySymbols()
per ottenerle.
var obj = {};
obj[Symbol('a')] = 'a';
obj[Symbol.for('b')] = 'b';
obj['c'] = 'c';
obj.d = 'd';
for (var i in obj) {
console.log(i); // logs "c" and "d"
}
Symbols e JSON.stringify()
Le proprietĂ le cui chiavi sono symbol vengono completamente ignorate da JSON.stringify()
:
JSON.stringify({[Symbol('foo')]: 'foo'});
// '{}'
Per ulteriori dettagli, vedere JSON.stringify()
.
Symbol wrapper objects come chiavi per le proprietĂ
Quando un oggetto wrapper symbol viene usato come chiave di una proprietĂ , tale oggetto verrĂ costretto al suo wrapped symbol:
var sym = Symbol('foo');
var obj = {[sym]: 1};
obj[sym]; // 1
obj[Object(sym)]; // still 1
Specificazioni
Specificazione | Stato | Commento |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Symbol' in that specification. |
Standard | Initial definition |
ECMAScript (ECMA-262) The definition of 'Symbol' in that specification. |
Living Standard |
Browser compatibility
BCD tables only load in the browser