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

CKTIS / JavaScript

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

String.prototype.slice devolve parte de uma cadeia de caracteres, desde start inclusive até end exclusivo, sem alterar a original. Os índices negativos contam a partir do fim; se end for omitido, é extraído o resto da 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

text.slice(start, end)

String.prototype.slice devolve um valor primitivo do tipo cadeia de caracteres sem alterar a original. Em text.slice(start, end), os índices começam em zero: start é incluído e end é excluído. Se start for omitido, considera-se 0; se end for omitido ou for undefined, considera-se o comprimento da cadeia. A chamada text.slice() devolve a cadeia inteira.

Um índice negativo é relativo ao fim: -1 identifica a última unidade de código. Depois do ajuste, os índices ficam limitados ao intervalo entre 0 e o comprimento da cadeia. Se o início for igual ou posterior ao fim, o resultado é "". Ao contrário de substring, slice não troca os limites.

Os argumentos de índice são convertidos em números; as partes fracionárias são truncadas em direção a zero e NaN passa a 0. Os índices referem-se a unidades de código UTF-16, não a caracteres tal como são percecionados pelas pessoas. Por isso, o corte pode separar um par de substitutos ou uma sequência que forme um único carácter visível.

É um método do padrão ECMAScript, não uma API Web. Pode ser utilizado por empréstimo com String.prototype.slice.call(value, start, end): o recetor é convertido numa cadeia de caracteres, mas null e undefined provocam um TypeError.

Exemplos

const text = "JavaScript";
console.log(text.slice(0, 4));
console.log(text.slice(4));
console.log(text.slice(-6, -2));
console.log(JSON.stringify(text.slice(7, 2)));
console.log(text);

Resultado

Java
Script
Scri
""
JavaScript

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