Il metodo statico String.raw()
è una funzione di tag del modello template string, simile al prefisso r
in Python o al prefisso @
in C# per i valori letterali stringa (tuttavia c'è una differenza: vedere le spiegazioni in questo numero ). È usato per ottenere la stringa di stringhe di template non formattata, cioè le sostituzioni (ad esempio ${foo}) vengono elaborate, ma gli escape (ad esempio \n
) non lo sono.
Sintassi
String.raw(callSite, ...substitutions)
String.raw`templateString`
Parametri
callSite
- Oggetto del sito di chiamata template ben formato, come
{ raw: ['foo', 'bar', 'baz'] }
. ...substitutions
- Contiene valori di sostituzione.
templateString
- A template string, puoi sostituirlo opzionalmente (
${...}
).
Valore resituto
Restituisce una stringa non elaborata di un determinato Template String.
Eccezioni
Descrizione
Nella maggior parte dei casi, String.raw()
viene utilizzato con template strings. La prima sintassi menzionata sopra è usata solo di rado, perché il motore JavaScript la chiamerà con argomenti appropriati, proprio come con altre funzioni tag .
String.raw()
è l'unica funzione di built-in tag incorporata nei template strings; funziona proprio come la funzione predefinita del modello ed esegue la concatenazione. Puoi anche ri-implementarlo con il normale codice JavaScript.
Esempi
Utilizzo di String.raw()
String.raw`Ciao\n${2+3}!`;
// 'Ciao\n5!', Il carattere dopo 'Ciao' non è un carattere di nuova riga,
// '\' e 'n' sono due caratteri.
String.raw`Hi\u000A!`;
// 'Ciao\u000A!', Lo stesso qui, questa volta avremo il
// \, u, 0, 0, 0, A, 6 caratteri.
// Tutti i tipi di caratteri di escape saranno inefficaci
// e backslash saranno presenti nella stringa di output
// Puoi confermare questo controllando la proprietà .length
// della stringa.
let name = 'Bob';
String.raw`Ciao\n${name}!`;
// 'Ciao\nBob!', le sostituzioni vengono elaborate.
// Normalmente non si chiama String.raw() come una funzione,
// ma la si chiama per simulare `t${0}e${1}s${2}t` puoi fare:
String.raw({ raw: 'test' }, 0, 1, 2); // 't0e1s2t'
// Nota che la stringa 'test', è un oggetto simile ad un array
// Il seguente è equivalente a
// `foo${2 + 3}bar${'Java' + 'Script'}baz`
String.raw({
raw: ['foo', 'bar', 'baz']
}, 2 + 3, 'Java' + 'Script'); // 'foo5barJavaScriptbaz'
Specificazioni
Specificazioni | Stato | Commento |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'String.raw' in that specification. |
Standard | Definizione iniziale. |
ECMAScript (ECMA-262) The definition of 'String.raw' in that specification. |
Living Standard |
Compatibilità con il browser
BCD tables only load in the browser
La tabella di compatibilità in questa pagina è generata da dati strutturati. Se desideri contribuire ai dati, consulta https://github.com/mdn/browser-compat-data e inviaci una richiesta di pull.