深入理解 TypeScript/JavaScript 中的静态方法-js教程-PHP中文网

深入理解 typescript/javascript 中的静态方法

本文旨在澄清TypeScript/JavaScript中静态方法的概念。尽管JavaScript基于原型，但ES6引入了`class`关键字，使其能够原生支持类和静态方法。静态方法不属于类的实例，而是直接附加到构造函数本身，用于处理与类整体或其集合相关的功能，而非特定实例的状态或行为。

JavaScript 的类与原型本质

长期以来，JavaScript 因其基于原型的继承机制，常被误认为是“无类语言”。然而，这一观念已不再完全准确。自 ECMAScript 2015 (ES6) 发布以来，JavaScript 正式引入了 class 关键字，提供了更符合传统面向对象编程（OOP）范式的语法糖，使得开发者能够以更直观的方式定义类和实现继承。尽管 class 关键字在底层仍然是基于原型链实现的，但它在语法层面提供了强大的抽象，使得 JavaScript 能够原生支持类和与之相关的特性，包括静态方法。

因此，现代 JavaScript 引擎完全支持 class 语法，并且在 TypeScript 中使用 class 更是自然而然。TypeScript 作为 JavaScript 的超集，在编译时会将 class 语法转换为兼容目标 JavaScript 版本的代码，通常是 ES6 或更早版本（如果配置了较低的 target）。

静态方法的概念与作用

在支持类的面向对象编程语言中，静态方法是类的一个成员，它不依赖于类的任何特定实例。这意味着静态方法可以直接通过类本身来调用，而无需先创建该类的一个对象。其核心特点在于：

不依赖实例状态： 静态方法不能直接访问类的实例属性或实例方法（除非通过传入实例作为参数）。它们主要用于处理与类本身相关的数据或执行与类整体相关的操作。
属于构造函数： 静态方法实际上是附加到类的构造函数上的属性，而不是附加到类的原型对象上。因此，类的实例无法直接访问静态方法。
常见用途：
- 工厂方法： 用于创建和返回类的实例，例如 Person.createFromJson(data)。
- 工具函数： 提供与类相关的通用实用功能，例如 Math.max()。
- 集合操作： 处理类所有实例的集合，例如从数据库中查找所有 Person 记录的 Person.findAll()。

以 Person 类为例，如果需要从数据库中查找所有人员记录，这个操作是针对所有 Person 对象集合的，而不是针对某个具体的 Person 实例。因此，将其设计为静态方法 Person.findAll() 更符合逻辑，因为单个 Person 实例本身并不需要具备查找所有 Person 的能力。

TypeScript/JavaScript 中静态方法的实现

在 TypeScript/JavaScript 中，通过 static 关键字来定义静态方法。当一个方法被标记为 static 时，它会被直接添加到构造函数对象上，而不是添加到构造函数的 prototype 对象上。原型对象上的方法是供实例访问的，而构造函数对象上的方法则是供类（构造函数）本身访问的。

这与实例方法的实现方式形成了鲜明对比：实例方法被添加到构造函数的 prototype 属性上，因此所有由该构造函数创建的实例都能通过原型链访问到这些方法。

代码示例

为了更好地理解静态方法的工作原理，我们来看两种实现方式：使用 ES6 class 语法和使用传统的函数构造器与原型链。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

1. 使用 ES6 class 语法

这是现代 JavaScript 和 TypeScript 中定义类和静态方法的推荐方式。

class Person {
  name: string;

  constructor(name: string) {
    this.name = name;
  }

  // 实例方法：属于 Person 的实例
  instanceMethod(): string {
    return `Hello, my name is ${this.name}.`;
  }

  // 静态方法：属于 Person 类本身
  static async findAll(): Promise<person> {
    // 模拟从数据库获取所有 Person 记录
    console.log("Fetching all person records...");
    return [new Person("Alice"), new Person("Bob")];
  }

  static getClassName(): string {
    return "Person";
  }
}

// 调用静态方法
async function main() {
  const people = await Person.findAll();
  console.log("Found people:", people.map(p => p.name)); // Output: Found people: [ 'Alice', 'Bob' ]

  console.log("Class Name:", Person.getClassName()); // Output: Class Name: Person

  // 创建实例并调用实例方法
  const alice = new Person("Alice");
  console.log(alice.instanceMethod()); // Output: Hello, my name is Alice.

  // 尝试通过实例调用静态方法会导致错误
  // console.log(alice.findAll()); // TypeError: alice.findAll is not a function
}

main();</person>

在这个例子中，findAll 和 getClassName 是 Person 类的静态方法，可以直接通过 Person.findAll() 和 Person.getClassName() 调用。而 instanceMethod 是一个实例方法，只能通过 new Person().instanceMethod() 这样的实例来调用。

2. 使用函数构造器和原型链 (ES5 及之前)

即使在 ES6 class 关键字出现之前，JavaScript 也能够通过函数构造器和原型链来模拟实现类和静态方法。

// 函数构造器
function PersonLegacy(name: string) {
  this.name = name;
}

// 实例方法：添加到原型上，供实例继承
PersonLegacy.prototype.instanceMethod = function(): string {
  return `Hello, my name is ${this.name}.`;
};

// 静态方法：直接添加到构造函数对象上
PersonLegacy.findAll = async function(): Promise<personlegacy> {
  console.log("Fetching all person records (legacy)...");
  return [new PersonLegacy("Charlie"), new PersonLegacy("David")];
};

PersonLegacy.getClassName = function(): string {
  return "PersonLegacy";
};

// 调用静态方法
async function mainLegacy() {
  const peopleLegacy = await PersonLegacy.findAll();
  console.log("Found people (legacy):", peopleLegacy.map(p => p.name)); // Output: Found people (legacy): [ 'Charlie', 'David' ]

  console.log("Class Name (legacy):", PersonLegacy.getClassName()); // Output: Class Name (legacy): PersonLegacy

  // 创建实例并调用实例方法
  const charlie = new PersonLegacy("Charlie");
  console.log(charlie.instanceMethod()); // Output: Hello, my name is Charlie.

  // 尝试通过实例调用静态方法会导致错误
  // console.log(charlie.findAll()); // TypeError: charlie.findAll is not a function
}

mainLegacy();</personlegacy>

从上述两个示例可以看出，无论采用哪种语法，静态方法的本质都是一样的：它们是直接附加到构造函数（或类）对象上的属性，而不是通过原型链传递给实例。static 关键字的作用，就是将方法从原型链中“移除”，转而直接绑定到构造函数本身。