HOWTO · JavaScript

Verificar se uma variável é uma string em JavaScript

Este tutorial explica como verificar se a variável é uma String ou não em JavaScript

Nesta página

Use typeof value === "string" para verificar se um valor é uma string primitiva. Esta costuma ser a opção adequada para validação. Aspas simples, aspas duplas e crases criam strings primitivas; o estilo das aspas não altera o tipo.

Verificar strings primitivas com typeof

O operador typeof devolve a string "string" para uma string primitiva. Compare o resultado com esse valor exato. Para números, valores booleanos, null e objetos, a comparação é falsa. Isso funciona com valores locais, argumentos de funções e valores recebidos de outro código.

Execute este exemplo:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

const primitive = "hello";
const boxed = new String("hello");
const number = 42;

console.log(typeof primitive);
console.log(typeof boxed);
console.log(typeof number === "string");
string
object
false

A string primitiva produz "string"; o valor criado com new String("hello") produz "object"; e 42 não passa na comparação com uma string primitiva. Ao validar um valor, use a comparação typeof value === "string".

Decidir se deve aceitar objetos String

JavaScript também tem objetos String, por vezes chamados de strings encapsuladas. new String("hello") cria um objeto desse tipo, enquanto String("hello"), sem new, devolve uma string primitiva. Prefira strings primitivas: valores encapsulados têm comportamento de objeto, o que pode causar surpresas em comparações e APIs.

O teste typeof aceita strings primitivas e rejeita objetos String, pois typeof new String("hello") é "object". Esse costuma ser o comportamento correto para validar entradas. Se uma API aceitar intencionalmente as duas formas, defina essa política explicitamente, em vez de enfraquecer todas as verificações de strings.

value instanceof String verifica se String.prototype do contexto de execução atual aparece na cadeia de protótipos do valor. O resultado é falso para strings primitivas e também pode ser falso para um objeto String legítimo criado em outro contexto, como outra janela ou frame do navegador. Essa verificação não prova que o objeto contém os dados internos de uma string encapsulada.

Compreender os limites das verificações alternativas

Object.prototype.toString.call(value) === "[object String]" pode identificar strings primitivas e objetos String comuns, incluindo muitos objetos de outros contextos de execução. Não é uma verificação universal de autenticidade: objetos podem personalizar o resultado com Symbol.toStringTag. Use essa verificação apenas se essa limitação for compatível com os valores tratados pelo seu código.

String.prototype.isPrototypeOf(value) verifica se String.prototype do contexto de execução atual aparece na cadeia de protótipos de um objeto. Aplica-se a objetos, não a valores primitivos, e tem uma limitação entre contextos semelhante à de instanceof. Nem esse método nem instanceof String provam que o valor é um objeto String legítimo ou contém dados internos de string: por exemplo, Object.create(String.prototype) pode passar nas duas verificações da cadeia de protótipos. Essas verificações respondem a perguntas diferentes e não são intercambiáveis. Para a validação de tipos habitual, use typeof value === "string" e decida separadamente se objetos encapsulados podem ser aceitos como entrada.

Perguntas frequentes

Como verifico se uma variável é uma string em JavaScript?

Use typeof value === "string" para aceitar strings primitivas. Essa é a opção padrão para a maioria dos dados recebidos por uma aplicação. Se também aceitar valores encapsulados, defina essa política separadamente; verificações da cadeia de protótipos, por si só, não provam que um objeto seja um objeto String legítimo.

Qual é a diferença entre strings primitivas e objetos String?

Uma string primitiva é um valor do tipo string. new String("hello") cria um objeto que encapsula uma string, por isso typeof devolve "object". Prefira strings primitivas, a menos que uma API precise especificamente de um objeto String.

instanceof String funciona com strings primitivas?

Não. instanceof verifica se um objeto herda do construtor String do contexto de execução atual. Strings primitivas não são objetos.

Que verificação devo escolher?

Use typeof para validar strings primitivas. Use instanceof String ou String.prototype.isPrototypeOf() apenas quando precisar verificar uma cadeia de protótipos de String do mesmo contexto de execução; nenhum dos dois comprova que se trata de um objeto encapsulado legítimo. Use Object.prototype.toString.call() quando precisar reconhecer strings primitivas e encapsuladas, levando em conta a personalização por Symbol.toStringTag. Um objeto String legítimo de outro contexto pode falhar nas verificações de protótipo do contexto atual.