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.