trim Method (String) (JavaScript)

2017-1-18 1 minutes to read Contributors

Removes the leading and trailing white space and line terminator characters from a string.

Syntax


stringObj.trim()

Parameters

stringObj
Required. A String object or string literal. This string is not modified by the trim method.

Return Value

The original string with leading and trailing white space and line terminator characters removed.

Remarks

The characters that are removed include space, tab, form feed, carriage return, and line feed. See Special Characters for a comprehensive list of white space and line terminator characters.

For an example that shows how to implement your own trim method, see Prototypes and Prototype Inheritance.

Example

The following example illustrates the use of the trim method.

var message = "    abc def     \r\n  ";  

document.write("[" + message.trim() + "]");  
document.write("<br/>");  
document.write("length: " + message.trim().length);  

// Output:  
//  [abc def]  
//  length: 7

Requirements

Supported in the following document modes: Internet Explorer 9 standards, Internet Explorer 10 standards, and Internet Explorer 11 standards. Also supported in Store apps (Windows 8 and Windows Phone 8.1). See Version Information.
Not supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards.