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

CKTIS / JavaScript

String.prototype.substring — extrair parte de uma cadeia de caracteres

substring() devolve a parte de uma cadeia de caracteres entre start e end, sem incluir end. Não altera a cadeia original, limita os índices ao seu comprimento e troca os limites se estiverem pela ordem inversa.

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

str.substring(start, end)

String.prototype.substring devolve uma cadeia de caracteres primitiva sem alterar a original. Os índices começam em zero: start é incluído e end é excluído. Se end for omitido ou se for passado undefined, é usado o fim da cadeia; se start for omitido, é usado zero.

Os argumentos são convertidos em números, e as partes fracionárias são truncadas em direção a zero. NaN e os valores negativos passam a zero; os valores superiores ao comprimento da cadeia são limitados a esse comprimento. Em seguida, o método troca os limites se start for superior a end. Limites iguais produzem "".

Ao contrário de slice(), os índices negativos não contam para trás a partir do fim e limites invertidos não forçam um resultado vazio. Os índices referem-se a unidades de código UTF-16, não a caracteres visíveis completos; separar um par substituto pode devolver um carácter incompleto.

Este é um método da biblioteca padrão ECMAScript, não uma API Web. O exemplo demonstra um intervalo, limites trocados, um índice negativo, a omissão de end e um resultado vazio.

Exemplos

const text = "JavaScript";
console.log(text.substring(4, 10));
console.log(text.substring(10, 4));
console.log(text.substring(-3, 4));
console.log(text.substring(4));
console.log(JSON.stringify(text.substring(4, 4)));

Resultado

Script
Script
Java
Script
""

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