[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/String/raw [Back]  [Original]

String.raw() - JavaScript | MDN

Esta pgina foi traduzida do ingls pela comunidade. Saiba mais e junte-se comunidade MDN Web Docs.

View in English Always switch to English

String.raw()

Baseline Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since setembro de 2015.

O mtodo esttico String.raw() uma funo tag de modelos literais, similar ao prefixo r no Python ou o prefixo @ no C# para string literais (Mas no idntico, existe uma diferena, veja explicaes nessa discusso). Ele usado para pegar as strings no formato "cru" de modelos literais, isto , substituies (ex: ${foo}) so processados, mas "escapes" (ex:. \n) no so.

In this article

Experimente

// Create a variable that uses a Windows
// path without escaping the backslashes:
const filePath = String.raw`C:\Development\profile\aboutme.html`;

console.log(`The file was uploaded from: ${filePath}`);
// Expected output: "The file was uploaded from: C:\Development\profile\aboutme.html"

Sintaxe

String.raw(callSite, ...sub)

String.raw`templateString`

Parmetros

callSite

Modelo bem-formatado de objeto de local de chamada, como { raw: ['foo', 'bar', 'baz'] }.

...substitutions

Contm os valores das substituies.

templateString

Um modelo string, opcionalmente com substituies (${...}).

Valor retornado

A forma crua de uma string de um modelo string dado.

Excees

TypeError

Um TypeError jogado se o primeiro argumento no um Objeto bem formado.

Descrio

Na maioria dos casos, String.raw() usado com modelos de strings. A primeira sintaxe mencionada acima raramente usada, porque o mecanismo JavaScript a chamar com os argumentos apropriados para voc, assim como com outras funes de tag.

String.raw() a nica funo de tag embutida de strings de template; ele funciona exatamente como a funo de modelo padro e executa a concatenao. Voc pode at reimplement-lo com o cdigo JavaScript normal.

Exemplos

Usando String.raw()

js
String.raw`Hi\n${2 + 3}!`;
// 'Hi\n5!', o caractere aps 'Hi'
// no  um caractere de quebra de linha,
// '\' e 'n' so dois caracteres.

String.raw`Hi\u000A!`;
// 'Hi\u000A!', o mesmo aqui, agora ns teremos os caracteres
//  \, u, 0, 0, 0, A, 6.
// Todos as formas de quebra de linha sero ineficazes
// e as contra barras estaro inclusas no valor retornado.
// Voc pode confirmar isso verificando a propriedade .length
// da string.

let name = "Bob";
String.raw`Hi\n${name}!`;
// 'Hi\nBob!', substituies so processadas.

// Normalmente voc no chamaria String.raw() como uma funo,
// mas para simular `t${0}e${1}s${2}t` voc pode fazer:
String.raw({ raw: "test" }, 0, 1, 2); // 't0e1s2t'
// Note que 'test', uma string,  um objeto array-like
// O cdigo abaixo  equivalente a:
// `foo${2 + 3}bar${'Java' + 'Script'}baz`
String.raw(
  {
    raw: ["foo", "bar", "baz"],
  },
  2 + 3,
  "Java" + "Script",
); // 'foo5barJavaScriptbaz'

Especificaes

Specification
ECMAScript 2027 LanguageSpecification
# sec-string.raw

Compatibilidade com navegadores

Veja tambm


Web Proxy Viewer  |  New URL  |  Original Page