在 ES12 中，新增了一个 Metadata API，它可以让开发者在代码中添加元数据，这些元数据可以用来描述代码的某些特征或属性，同时也可以帮助开发者更好地理解和维护代码。本文将详细介绍 ES12 的公约定 Metadata API，包括其基本用法、示例代码以及学习和指导意义。
什么是 Metadata API
Metadata API 是 ES12 中新增的一个 API，它可以让开发者在代码中添加元数据，这些元数据可以用来描述代码的某些特征或属性。元数据是指描述数据的数据，它可以让开发者更好地理解和维护代码，同时也可以用来实现一些高级的功能，比如代码注入、依赖注入等。
Metadata API 的基本用法
Metadata API 的基本用法非常简单，只需要使用 Reflect.metadata 方法来添加元数据即可。该方法接收两个参数，第一个参数是元数据的键，第二个参数是元数据的值。例如：
class Person {
@Reflect.metadata('name', 'John')
getName() {
return 'John';
}
}上面的代码中，我们使用 Reflect.metadata 方法在 getName 方法上添加了一个名为 name 的元数据，其值为 'John'。
在使用元数据时，我们可以通过 Reflect.getMetadata 方法来获取元数据的值。例如：
const name = Reflect.getMetadata('name', Person.prototype.getName);
console.log(name); // 'John'上面的代码中，我们使用 Reflect.getMetadata 方法来获取 getName 方法上的 name 元数据的值，即 'John'。
Metadata API 的示例代码
下面是一个更完整的示例代码，其中包含了如何使用 Metadata API 来实现依赖注入的功能：
// www.javascriptcn.com code example
const dependencies = new Map();
function Injectable() {
return function(target) {
dependencies.set(target, []);
};
}
function Inject(token) {
return function(target, key, index) {
const deps = dependencies.get(target.constructor);
deps[index] = token;
};
}
@Injectable()
class PersonService {
constructor() {
console.log('PersonService constructor');
}
getPerson() {
console.log('PersonService getPerson');
return { name: 'John', age: 30 };
}
}
@Injectable()
class PersonComponent {
constructor(personService) {
console.log('PersonComponent constructor');
this.personService = personService;
}
displayPerson() {
console.log('PersonComponent displayPerson');
const person = this.personService.getPerson();
console.log(person);
}
}
const personComponentDeps = dependencies.get(PersonComponent);
const personServiceToken = personComponentDeps[0];
const personService = new PersonService();
const personComponent = new PersonComponent(personService);
console.log(personComponent.displayPerson());上面的代码中，我们使用了两个装饰器 Injectable 和 Inject 来实现依赖注入的功能。其中，Injectable 装饰器用来标记一个类为可注入的，Inject 装饰器用来标记一个类的构造函数参数为依赖项。
在代码中，我们首先定义了一个 dependencies Map，用来保存所有可注入的类及其依赖项。然后，我们使用 Injectable 装饰器来标记 PersonService 和 PersonComponent 两个类为可注入的。接着，我们在 PersonComponent 类的构造函数参数上使用 Inject 装饰器来标记 personService 参数为 PersonService 类的实例。
最后，我们通过 dependencies Map 来获取 PersonComponent 类的依赖项，并创建 PersonService 和 PersonComponent 类的实例。在 PersonComponent 类的实例化过程中，我们将 PersonService 类的实例作为构造函数参数传入，从而实现了依赖注入的功能。
Metadata API 的学习和指导意义
Metadata API 的出现，为 JavaScript 开发者提供了一种新的方式来描述代码的特征和属性。它可以让我们更好地理解和维护代码，同时也可以用来实现一些高级的功能，比如代码注入、依赖注入等。
在学习和使用 Metadata API 时，我们需要注意以下几点：
- 元数据的键必须是字符串类型。
- 元数据的值可以是任意类型，包括基本类型和对象类型。
- 元数据只能添加在类的属性和方法上，不能添加在类本身上。
- 元数据只能在运行时使用，不能在编译时使用。
总之，Metadata API 是一个非常有用的功能，可以让我们更好地理解和维护代码，同时也可以用来实现一些高级的功能。在实际开发中，我们可以根据需要来使用 Metadata API，从而提高代码的可读性和可维护性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67d4dfe3a941bf7134919bf5