String.prototype.trim()

O método trim() remove os espaços em branco (whitespaces) do início e/ou fim de um texto. É considerado espaço em branco (espaço, tabulação, espaço fixo/rígido, etc.) e todo sinal de fim de linha de texto (LF, CR, etc.).

Sintaxe

str.trim()

Descrição

O método trim() retorna o texto sem espaços em branco no início e/ou fim da string. O trim() não altera o valor da string original.

Exemplos

Usando trim()

Os exemplos a seguir retornam o valor de 'foo' sem espaços em branco:

//.trim() removendo whitespace de ambos os lados

var str = '   foo  ';
console.log(str.trim()); // retorna 'foo'

// Outro exemplo de .trim() removendo whitespace de
// apenas um lado.

var str= 'foo    ';
console.log(str.trim()); // retorna 'foo'

Polyfill

Executar o seguinte código antes antes de qualquer código irá criar o método trim() se o mesmo não estiver disponível nativamente.

if (!String.prototype.trim) {
  String.prototype.trim = function () {
    return this.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, '');
  };
}

Especificações

Specification Status Comment
ECMAScript 5.1 (ECMA-262)
The definition of 'String.prototype.trim' in that specification.
Padrão Definição inicial. Implementado no JavaScript 1.8.1.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype.trim' in that specification.
Padrão
Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico (Yes) 3.5 (1.9.1) 9 10.5 5
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Veja também