String.prototype.trimEnd()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
The trimEnd()
method of String
values removes whitespace from the end of this string and returns a new string, without modifying the original string. trimRight()
is an alias of this method.
Try it
Syntax
trimEnd()
trimRight()
Parameters
None.
Return value
A new string representing str
stripped of whitespace from its end (right side). Whitespace is defined as white space characters plus line terminators.
If the end of str
has no whitespace, a new string is still returned (essentially a copy of str
).
Aliasing
After trim()
was standardized, engines also implemented the non-standard method trimRight
. However, for consistency with padEnd()
, when the method got standardized, its name was chosen as trimEnd
. For web compatibility reasons, trimRight
remains as an alias to trimEnd
, and they refer to the exact same function object. In some engines this means:
String.prototype.trimRight.name === "trimEnd";
Examples
Using trimEnd()
The following example trims whitespace from the end of str
, but not from its start.
let str = " foo ";
console.log(str.length); // 8
str = str.trimEnd();
console.log(str.length); // 6
console.log(str); // ' foo'
Specifications
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.trimend |
Browser compatibility
BCD tables only load in the browser