From c572b57c277d75466e91bdb2b57c8717bc9be026 Mon Sep 17 00:00:00 2001
From: ruanyf <yifeng.ruan@gmail.com>
Date: Mon, 22 Apr 2019 15:24:36 +0800
Subject: [PATCH] docs(string): add trimStart()/trimEnd()

---
 docs/string.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/string.md b/docs/string.md
index 4359949..995857c 100644
--- a/docs/string.md
+++ b/docs/string.md
@@ -329,6 +329,24 @@ ES2017 引入了字符串补全长度的功能。如果某个字符串不够指
 '09-12'.padStart(10, 'YYYY-MM-DD') // "YYYY-09-12"
 ```
 
+## trimStart()，trimEnd()
+
+ES2019 对字符串实例新增了`trimStart()`和`trimEnd()`这两个方法。它们的行为与`trim()`一致，`trimStart()`消除字符串头部的空格，`trimEnd()`消除尾部的空格。它们返回的都是新字符串，不会修改原始字符串。
+
+```javascript
+const s = '  abc  ';
+
+s.trim() // "abc"
+s.trimStart() // "abc  "
+s.trimEnd() // "  abc"
+```
+
+上面代码中，`trimStart()`只消除头部的空格，保留尾部的空格。`trimEnd()`也是类似行为。
+
+除了空格键，这两个方法对字符串头部（或尾部）的 tab 键、换行符等不可见的空白符号也有效。
+
+浏览器还部署了额外的两个方法，`trimLeft()`是`trimStart()`的别名，`trimRight()`是`trimEnd()`的别名。
+
 ## matchAll()
 
 `matchAll`方法返回一个正则表达式在当前字符串的所有匹配，详见《正则的扩展》的一章。