JavaScript String substring()
Exemplos
Extraia uma substring do texto:
let text = "Hello world!";
let result = text.substring(1, 4);
Comece da posição 2:
let result = text.substring(2);
Mais exemplos abaixo.
Definição e uso
O substring()
método extrai caracteres, entre dois índices (posições), de uma string e retorna a substring.
O substring()
método extrai caracteres do início ao fim (excusive).
O substring()
método não altera a string original.
Se start for maior que end, os argumentos são trocados: (1, 4) = (4, 1).
Início ou fim menor que 0 são tratados como 0.
Sintaxe
string.substring(start, end)
Parâmetros
Parameter | Description |
start | Required. Start position. First character is at index 0. |
end | Optional. End position (up to, but not including). If omitted: the rest of the string. |
Valor de retorno
Modelo | Descrição |
Uma linha | Uma string contendo os caracteres extraídos. |
Mais exemplos
Se start for maior que end, os parâmetros são trocados:
let result = text.substring(4, 1);
Se "start" for menor que 0, ele começará do índice 0:
let result = text.substring(-3);
Apenas o primeiro:
let result = text.substring(0, 1);
Apenas o último:
let result = text.substring(text.length - 1);
Suporte ao navegador
substring()
é um recurso ECMAScript1 (ES1).
ES1 (JavaScript 1997) é totalmente suportado em todos os navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes | Yes |