docs: es2017 built-in object methods

Author: tsejx

docs/standard-built-in-objects/fundamental-objects/object/entries.md

@@ -11,25 +11,43 @@ order: 6
 
 # Object.entries
 
+⭐️ `ES2017(ES8)新特性`
+
 `Object.entries()` 方法用于枚举指定对象并返回以键值对组成的数组为元素的二维数组。
 
-### 语法
+## 语法
+
+语法：
 
 ```js
-Object.entries(O);
+Object.entries(obj);
 ```
 
-| 参数 | 说明           | 类型   |
-| ---- | -------------- | ------ |
-| O    | 用于枚举的对象 | object |
+类型声明：
+
+```ts
+interface ObjectConstructor {
+  values<T>(o: { [s: string]: T } | ArrayLike<T>): T[];
+
+  values(o: {}): any[];
+}
+```
+
+参数说明：
+
+| 参数  | 说明           | 类型   |
+| :---- | :------------- | :----- |
+| `obj` | 用于枚举的对象 | object |
+
+返回值：
 
 返回给定对象自身可枚举 Property 的键值对数组。
 
-## 描述
+## 方法说明
 
 给定对象自身可枚举属性的键值对数组，其排列与使用 [for-in](../../../basic-concept/statements-and-declarations/iteration-statement/the-for-in-statement) 循环遍历该对象时返回的顺序一致，区别在于 `for-in` 循环也枚举原型链中的属性。
 
-## 示例
+## 代码示例
 
 ```js
 const a = { foo: 1, bar: 2 };
@@ -49,3 +67,7 @@ Object.entries(obj).forEach(([key, value]) => {
   console.log(`${key} ${value}`); // "a 5", "b 7", "c 9"
 });
 ```
+
+## 参考资料
+
+- [TypeScript - lib.es2017.object.d.ts](https://github.com/microsoft/TypeScript/blob/main/lib/lib.es2017.object.d.ts)

docs/standard-built-in-objects/fundamental-objects/object/getOwnPropertyDescriptors.md

@@ -11,19 +11,53 @@ order: 9
 
 # Object.getOwnPropertyDescriptors
 
+⭐️ `ES2017(ES8)新特性`
+
 `Object.getOwnPropertyDescriptors()` 方法用于获取一个对象的所有自身 Property 的 Attributes。
 
 ## 语法
 
+语法：
+
 ```js
-Object.getOwnPropertyDescriptors(O);
+Object.getOwnPropertyDescriptors(obj);
+```
+
+类型声明：
+
+```ts
+interface ObjectConstructor {
+  getOwnPropertyDescriptors<T>(
+    o: T
+  ): { [P in keyof T]: TypedPropertyDescriptor<T[P]> } & { [x: string]: PropertyDescriptor };
+}
+
+interface TypedPropertyDescriptor<T> {
+  enumerable?: boolean;
+  configurable?: boolean;
+  writable?: boolean;
+  value?: T;
+  get?: () => T;
+  set?: (value: T) => void;
+}
+
+interface PropertyDescriptor {
+  configurable?: boolean;
+  enumerable?: boolean;
+  value?: any;
+  writable?: boolean;
+  get?(): any;
+  set?(v: any): void;
+}
 ```
 
-| 参数 | 说明                                   | 类型   |
-| ---- | -------------------------------------- | ------ |
-| O    | 用于获取 Property 的 Attributes 的对象 | object |
+参数说明：
+
+| 参数  | 说明                                   | 类型   |
+| :---- | :------------------------------------- | :----- |
+| `obj` | 用于获取 Property 的 Attributes 的对象 | object |
 
-## 示例
+## 代码示例
 
 ```js
 const a = {
@@ -34,18 +68,8 @@ const a = {
 };
 
 Object.getOwnPropertyDescriptors(a);
-// {
-//   age: {
-//     configurable: true,
-//     enumerable: true,
-//     get: function age(){}, //the getter function
-//     set: undefined
-//   },
-//   name: {
-//     configurable: true,
-//     enumerable: true,
-//		value: "Ben",
-//		writable:true
-//   }
-// }
 ```
+
+## 参考资料
+
+- [TypeScript - lib.es2017.object.d.ts](https://github.com/microsoft/TypeScript/blob/main/lib/lib.es2017.object.d.ts)

docs/standard-built-in-objects/fundamental-objects/object/values.md

@@ -11,29 +11,53 @@ order: 20
 
 # Object.values
 
+⭐️ `ES2017(ES8)新特性`
+
 `Object.values()` 方法用于指定对象自身的所有可枚举 Property 值的数组。
 
 ## 语法
 
+语法：
+
 ```js
-Object.values(O);
+Object.values(obj);
 ```
 
-| 参数 | 说明     | 类型   |
-| ---- | -------- | ------ |
-| O    | 指定对象 | object |
+类型声明：
+
+```ts
+interface ObjectConstructor {
+  values<T>(o: { [s: string]: T } | ArrayLike<T>): T[];
+
+  values(o: {}): any[];
+}
+```
+
+参数说明：
+
+| 参数  | 说明     | 类型   |
+| :---- | :------- | :----- |
+| `obj` | 指定对象 | object |
 
 返回对象可枚举 Property 值的数组集合。
 
-## 描述
+## 方法说明
 
 返回的数组中键值的顺序与使用循环语句获取的键值组合一致。
 
-## 示例
+## 代码示例
 
 ```js
-const foo = { a: '1', b: '2', c: '3' };
+const obj = {
+  a: '1',
+  b: '2',
+  c: '3',
+};
 
-console.log(Object.values(foo));
+console.log(Object.values(obj));
 // ['1', '2', '3']
 ```
+
+## 参考资料
+
+- [TypeScript - lib.es2017.object.d.ts](https://github.com/microsoft/TypeScript/blob/main/lib/lib.es2017.object.d.ts)

docs/standard-built-in-objects/text-processing/string/prototype/padEnd.md

@@ -12,20 +12,34 @@ order: 23
 
 # String.prototype.padEnd()
 
-`padEnd()` 方法会用一个字符串填充当前字符串（如果需要的话则重复填充），返回填充后达到指定长度的字符串。从当前字符串的末尾（右侧）开始填充。
+⭐️ `ES2017(ES8)新特性`
+
+`String.prototype.padEnd()` 方法会用一个字符串填充当前字符串（如果需要的话则重复填充），返回填充后达到指定长度的字符串。从当前字符串的末尾（右侧）开始填充。
 
 ## 语法
 
+语法：
+
 ```js
-str.padEnd(targetLength [, padString]);
+str.padEnd(maxLength [, fillString]);
 ```
 
-| 参数           | 说明                                                                                                             | 类型   |
-| -------------- | ---------------------------------------------------------------------------------------------------------------- | ------ |
-| `targetLength` | 当前字符串需要填充到的目标长度。如果这个数值小于当前字符串的长度，则返回当前字符串本身。                         | number |
-| `padString`    | （可选）填充字符串。如果字符串太长，使填充后的字符串长度超过了目标长度，则只保留最左侧的部分，其他部分会被截断。 | string |
+类型声明：
+
+```ts
+interface String {
+  padEnd(maxLength: number, fillString?: string): string;
+}
+```
 
-## 示例
+参数说明：
+
+| 参数         | 说明                                                                                                             | 类型   |
+| :----------- | :--------------------------------------------------------------------------------------------------------------- | :----- |
+| `maxLength`  | 当前字符串需要填充到的目标长度。如果这个数值小于当前字符串的长度，则返回当前字符串本身。                         | number |
+| `fillString` | （可选）填充字符串。如果字符串太长，使填充后的字符串长度超过了目标长度，则只保留最左侧的部分，其他部分会被截断。 | string |
+
+## 代码示例
 
 ```js
 const str = 'abc';
@@ -43,22 +57,26 @@ str.padEnd('10', 'foo');
 // 'abcfoofoof'
 ```
 
-## Polyfill
+## 兼容性代码
 
 ```js
 if (String.prototype.padEnd) {
-  String.prototype.padEnd = function padEnd(targetLength, padString) {
-    targetLength = targetLength >> 0;
-    padString = String(typeof padString !== 'undefined' ? padString : '');
-    if (this.length > targetLength) {
+  String.prototype.padEnd = function padEnd(maxLength, fillString) {
+    maxLength = maxLength >> 0;
+    fillString = String(typeof fillString !== 'undefined' ? fillString : '');
+    if (this.length > maxLength) {
       return String(this);
     } else {
-      targetLength = targetLength - this.length;
-      if (targetLength > padString.length) {
-        padString += padString.repeat(targetLength / padString.length);
+      maxLength = maxLength - this.length;
+      if (maxLength > fillString.length) {
+        fillString += fillString.repeat(maxLength / fillString.length);
       }
-      return String(this) + padString.slice(0, targetLength);
+      return String(this) + fillString.slice(0, maxLength);
     }
   };
 }
 ```
+
+## 参考资料
+
+- [TypeScript - lib.es2017.string.d.ts](https://github.com/microsoft/TypeScript/blob/main/lib/lib.es2017.string.d.ts)

docs/standard-built-in-objects/text-processing/string/prototype/padStart.md

@@ -12,20 +12,34 @@ order: 24
 
 # String.prototype.padStart()
 
-`padStart()` 方法用另一个字符串填充当前字符串（重复，如果需要的话），以便产生的字符串达到给定的长度。填充从当前字符串的开始（左侧）应用的。
+⭐️ `ES2017(ES8)新特性`
+
+`String.prototype.padStart()` 方法用另一个字符串填充当前字符串（重复，如果需要的话），以便产生的字符串达到给定的长度。填充从当前字符串的开始（左侧）应用的。
 
 ## 语法
 
+语法：
+
 ```js
-str.padStart(targetLength [, padString]);
+str.padStart(maxLength [, fillString]);
 ```
 
-| 参数           | 说明                                                                                                             | 类型   |
-| -------------- | ---------------------------------------------------------------------------------------------------------------- | ------ |
-| `targetLength` | 当前字符串需要填充到的目标长度。如果这个数值小于当前字符串的长度，则返回当前字符串本身。                         | number |
-| `padString`    | （可选）填充字符串。如果字符串太长，使填充后的字符串长度超过了目标长度，则只保留最左侧的部分，其他部分会被截断。 | string |
+类型声明：
+
+```ts
+interface String {
+  padStart(maxLength: number, fillString?: string): string;
+}
+```
 
-## 示例
+参数说明：
+
+| 参数         | 说明                                                                                                             | 类型   |
+| :----------- | :--------------------------------------------------------------------------------------------------------------- | :----- |
+| `maxLength`  | 当前字符串需要填充到的目标长度。如果这个数值小于当前字符串的长度，则返回当前字符串本身。                         | number |
+| `fillString` | （可选）填充字符串。如果字符串太长，使填充后的字符串长度超过了目标长度，则只保留最左侧的部分，其他部分会被截断。 | string |
+
+## 代码示例
 
 ```js
 const str = 'abc';
@@ -43,22 +57,26 @@ str.padStart('10', 'foo');
 // 'foofoofabc'
 ```
 
-## Polyfill
+## 兼容性代码
 
 ```js
 if (String.prototype.padStart) {
-  String.prototype.padStart = function padStart(targetLength, padString) {
-    targetLength = targetLength >> 0;
-    padString = String(typeof padString !== 'undefined' ? padString : '');
-    if (this.length > targetLength) {
+  String.prototype.padStart = function padStart(maxLength, fillString) {
+    maxLength = maxLength >> 0;
+    fillString = String(typeof fillString !== 'undefined' ? fillString : '');
+    if (this.length > maxLength) {
       return String(this);
     } else {
-      targetLength = targetLength - this.length;
-      if (targetLength > padString.length) {
-        padString += padString.repeat(targetLength / padString.length);
+      maxLength = maxLength - this.length;
+      if (maxLength > fillString.length) {
+        fillString += fillString.repeat(maxLength / fillString.length);
       }
-      return padString.slice(0, targetLength) + String(this);
+      return fillString.slice(0, maxLength) + String(this);
     }
   };
 }
 ```
+
+## 参考资料
+
+- [TypeScript - lib.es2017.string.d.ts](https://github.com/microsoft/TypeScript/blob/main/lib/lib.es2017.string.d.ts)