String.prototype.slice()

Sumário

O método slice() extrai uma sessão de uma string e retorna uma nova  string.

Sintaxe

str.slice(inicioSlice[, fimSlice])

Paramêtros

inicioSlice

O indíce base-zero que se inicia a extração. Se negativo, é considerado como sourceLength + beginSlice onde sourceLength é o tamanho da string (por exemplo, se inicioSlice é -3 é tratado como sourceLength - 3).

fimSlice

Opcional. O indíce base-zero no qual termina a extração. Se omitido, slice() extrairá até o fim da string. Se negativo, é tratado como sourceLength + fimSlice where sourceLength é o tamanho da string (por exemplo, se fimSlice é -3 é tratado como sourceLength - 3).

Descrição

slice() extrai um texto de uma string e retorna uma nova string.  Modificações no texto de uma string não afetam a outra string.

slice() extrai até, mas não inclue fimSlice. str.slice(1, 4) extrai a partir do segundo carácter até o quarto carácter (caracteres indexados 1, 2, e 3).

Exemplo, str.slice(2, -1) extrai a partir do terceiro carácter até o penultimo carácter da string.

Exemplos

Exemplos: Usando slice() para criar uma nova string

O exemplo a seguir usa slice() para criar uma nova string.

var str1 = 'The morning is upon us.';
var str2 = str1.slice(4, -2);

console.log(str2); // OUTPUT: morning is upon u

Exemplo: Usando slice() com indíces negativos.

O exemplo a seguir usa o slice() com indíces negativos.

var str = 'The morning is upon us.';
str.slice(-3);     // returns 'us.'
str.slice(-3, -1); // returns 'us'
str.slice(0, -1);  // returns 'The morning is upon us'

Especificações

Compatibilidade entre Browsers

Veja também

• String.prototype.substr()
• String.prototype.substring()
• Array.prototype.slice()