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()

js
//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

BCD tables only load in the browser

Veja também