From 1fa35d5c7b1b5e81efc1368e08f3817559d31b1e Mon Sep 17 00:00:00 2001 From: ruanyf Date: Tue, 17 Jan 2017 16:09:32 +0800 Subject: [PATCH] =?UTF-8?q?docs(class):=20=E8=B0=83=E6=95=B4=E2=80=9D?= =?UTF-8?q?=E7=B1=BB=E7=9A=84=E7=A7=81=E6=9C=89=E5=B1=9E=E6=80=A7=E2=80=9C?= =?UTF-8?q?=E4=B8=80=E8=8A=82=E7=9A=84=E4=BD=8D=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/class.md | 96 +++++++++++++++++++++++++-------------------------- 1 file changed, 48 insertions(+), 48 deletions(-) diff --git a/docs/class.md b/docs/class.md index fe70f34..3e0f249 100644 --- a/docs/class.md +++ b/docs/class.md @@ -419,50 +419,6 @@ export default class myClass{ 上面代码中，`bar`和`snaf`都是`Symbol`值，导致第三方无法获取到它们，因此达到了私有方法和私有属性的效果。 -### 私有属性 - -目前，有一个[提案](https://github.com/tc39/proposal-private-fields)，为`class`加了私有属性。方法是在属性名之前，使用`#`表示。 - -```javascript -class Point { - #x; - - constructor(x = 0) { - #x = +x; - } - - get x() { return #x } - set x(value) { #x = +value } -} -``` - -上面代码中，`#x`就表示私有属性`x`，在`Point`类之外是读取不到这个属性的。还可以看到，私有属性与实例的属性是可以同名的（比如，`#x`与`get x()`）。 - -私有属性可以指定初始值，在构造函数执行时进行初始化。 - -```javascript -class Point { - #x = 0; - constructor() { - #x; // 0 - } -} -``` - -之所以要引入一个新的前缀`#`表示私有属性，而没有采用`private`关键字，是因为 JavaScript 是一门动态语言，使用独立的符号似乎是唯一的可靠方法，能够准确地区分一种属性是私有属性。另外，Ruby 语言使用`@`表示私有属性，ES6 没有用这个符号而使用`#`，是因为`@`已经被留给了 Decorator。 - -该提案只规定了私有属性的写法。但是，很自然地，它也可以用来写私有方法。 - -```javascript -class Foo { - #a; - #b; - #sum() { return #a + #b; } - printSum() { console.log(#sum()); } - constructor(a, b) { #a = a; #b = b; } -} -``` - ### this的指向 类的方法内部如果含有`this`，它默认指向类的实例。但是，必须非常小心，一旦单独使用该方法，很可能报错。 @@ -1209,9 +1165,9 @@ var descriptor = Object.getOwnPropertyDescriptor( 上面代码中，存值函数和取值函数是定义在`html`属性的描述对象上面，这与ES5完全一致。 -## Class的Generator方法 +## Class 的 Generator 方法 -如果某个方法之前加上星号（`*`），就表示该方法是一个Generator函数。 +如果某个方法之前加上星号（`*`），就表示该方法是一个 Generator 函数。 ```javascript class Foo { @@ -1232,9 +1188,9 @@ for (let x of new Foo('hello', 'world')) { // world ``` -上面代码中，Foo类的Symbol.iterator方法前有一个星号，表示该方法是一个Generator函数。Symbol.iterator方法返回一个Foo类的默认遍历器，for...of循环会自动调用这个遍历器。 +上面代码中，`Foo`类的`Symbol.iterator`方法前有一个星号，表示该方法是一个 Generator 函数。`Symbol.iterator`方法返回一个`Foo`类的默认遍历器，`for...of`循环会自动调用这个遍历器。 -## Class的静态方法 +## Class 的静态方法 类相当于实例的原型，所有在类中定义的方法，都会被实例继承。如果在一个方法前，加上`static`关键字，就表示该方法不会被实例继承，而是直接通过类来调用，这就称为“静态方法”。 @@ -1409,6 +1365,50 @@ class Foo { 上面代码中，老写法的静态属性定义在类的外部。整个类生成以后，再生成静态属性。这样让人很容易忽略这个静态属性，也不符合相关代码应该放在一起的代码组织原则。另外，新写法是显式声明（declarative），而不是赋值处理，语义更好。 +## 类的私有属性 + +目前，有一个[提案](https://github.com/tc39/proposal-private-fields)，为`class`加了私有属性。方法是在属性名之前，使用`#`表示。 + +```javascript +class Point { + #x; + + constructor(x = 0) { + #x = +x; + } + + get x() { return #x } + set x(value) { #x = +value } +} +``` + +上面代码中，`#x`就表示私有属性`x`，在`Point`类之外是读取不到这个属性的。还可以看到，私有属性与实例的属性是可以同名的（比如，`#x`与`get x()`）。 + +私有属性可以指定初始值，在构造函数执行时进行初始化。 + +```javascript +class Point { + #x = 0; + constructor() { + #x; // 0 + } +} +``` + +之所以要引入一个新的前缀`#`表示私有属性，而没有采用`private`关键字，是因为 JavaScript 是一门动态语言，使用独立的符号似乎是唯一的可靠方法，能够准确地区分一种属性是私有属性。另外，Ruby 语言使用`@`表示私有属性，ES6 没有用这个符号而使用`#`，是因为`@`已经被留给了 Decorator。 + +该提案只规定了私有属性的写法。但是，很自然地，它也可以用来写私有方法。 + +```javascript +class Foo { + #a; + #b; + #sum() { return #a + #b; } + printSum() { console.log(#sum()); } + constructor(a, b) { #a = a; #b = b; } +} +``` + ## new.target属性 `new`是从构造函数生成实例的命令。ES6为`new`命令引入了一个`new.target`属性，（在构造函数中）返回`new`命令作用于的那个构造函数。如果构造函数不是通过`new`命令调用的，`new.target`会返回`undefined`，因此这个属性可以用来确定构造函数是怎么调用的。