String.prototype.slice()

Esta tradução está incompleta. Ajude atraduzir este artigo.

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

Specification Status Comment
ECMAScript 3rd Edition. Standard Initial definition. Implemented in JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
The definition of 'String.prototype.slice' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype.slice' in that specification.
Standard  

Compatibilidade entre Browsers

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: andresmachado, brunopulis
 Última atualização por: andresmachado,