Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

String.prototype.startsWith — verificar o prefixo de uma cadeia de caracteres

O método startsWith verifica se uma cadeia de caracteres tem um determinado prefixo no início ou exatamente numa posição indicada. Devolve um valor booleano, distingue maiúsculas de minúsculas e não altera a cadeia.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

string.startsWith(searchString[, position])

String.prototype.startsWith devolve true quando searchString corresponde exatamente ao índice position; caso contrário, devolve false. Não procura correspondências em posições posteriores e não altera a cadeia de caracteres.

O valor predefinido de position é 0. O valor é convertido num número inteiro, truncando a parte fracionária na direção de zero, e depois limitado ao intervalo entre 0 e o comprimento da cadeia; NaN significa 0. Os índices contam unidades de código UTF-16, que não correspondem necessariamente a caracteres completos tal como são entendidos pelo utilizador.

A comparação distingue maiúsculas de minúsculas e não normaliza Unicode. Um searchString vazio devolve true, mesmo quando a posição indicada ultrapassa o comprimento da cadeia. Os outros valores são convertidos em cadeias: se o argumento for omitido, a pesquisa é por "undefined". Uma expressão regular comum provoca um TypeError.

O método também pode funcionar com outros recetores através de call, convertendo-os em cadeias, mas um recetor null ou undefined provoca um TypeError. Esta é uma API da linguagem ECMAScript, não uma API DOM; a especificação, por si só, não comprova o suporte num navegador específico.

Exemplos

const text = "Hello, world!";
console.log(text.startsWith("Hello"));
console.log(text.startsWith("hello"));
console.log(text.startsWith("world", 7));
console.log(text.startsWith("world", 6));
console.log(text.startsWith("", 99));

Resultado

true
false
true
false
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes