String.prototype.startsWith()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
O método startsWith()
determina se uma string começa com os caracteres especificados, retornando true
ou false
.
Experimente
Sintaxe
str.startsWith(searchString[, position])
Parâmetros
searchString
-
Os caracteres a serem procurados a partir do início dessa string.
position
-
Opcional. A posição nessa string na qual se inicia a busca pela
searchString
. O valor padrão é0
.
Valor retornado
true
se os caracteres fornecidos forem encontrados no início da string. Se não, false
.
Descrição
Esse método permite determinar se uma string começa ou não com outra string. Esse método é case-sensitive (difere maiúsculas de minúsculas, e vice-versa).
Exemplos
Usando startsWith()
//startswith
let str = "Ser ou não ser, eis a questão.";
console.log(str.startsWith("Ser")); // true
console.log(str.startsWith("não ser")); // false
console.log(str.startsWith("não ser", 7)); // true
Polyfill
Este método foi adicionaldo à especificação ECMAScript 2015 e pode ainda não estar disponível em todas as implementações do JavaScript. No entanto, você pode usar o polyfill String.prototype.startsWith()
adicionando o seguinte código:
if (!String.prototype.startsWith) { Object.defineProperty(String.prototype, 'startsWith', { value: function(search, rawPos) { var pos = rawPos > 0 ? rawPos|0 : 0; return this.substring(pos, pos + search.length) === search; } }); }
Um polyfill mais robusto (totalmente conforme com a especificação ES2015), mas com menor desempenho e compacto está disponível no GitHub por Mathias Bynens.
Especificações
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.startswith |
Navegadores compatíveis
BCD tables only load in the browser