CommonJS模块实现链式调用需让每个方法返回this或新实例，导出构造函数或工厂函数以控制this指向和实例隔离；同步方法一律return this，异步逻辑延迟至.exec()等执行方法触发；构建态（where、sort）与执行态（run、first）须分离，避免同步I/O；注意require缓存导致的状态共享风险，推荐工厂函数或构造时初始化状态。
CommonJS 本身不提供链式调用能力，链式调用是开发者基于返回值设计的编程模式。在 Node.js 的 CommonJS 模块中实现服务层工具的链式调用，核心在于让每个方法都返回 this（或新实例），并确保模块导出的是一个可连续调用的对象实例。
导出构造函数或工厂函数
避免直接导出普通对象，改用构造函数或工厂函数封装状态和方法，便于控制 this 指向与链式上下文：
- 使用 function 构造器或 class 定义服务类，所有业务方法返回 this
- 模块末尾用 module.exports = new Service() 或 module.exports = () => new Service()，保证每次 require 得到一致的可链式实例
- 若需多实例隔离（如带不同配置），推荐工厂函数：module.exports = (config) => new Service(config)
每个方法必须返回 this 或兼容链式的对象
这是链式调用成立的前提。不能在中间方法里返回原始值、Promise 或 undefined：
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 同步方法：一律 return this
- 异步方法（如调用数据库或 HTTP）：return this（不 await）；真正异步逻辑通过后续 .then() 或单独 .exec() 触发
- 例如：user.where({id: 1}).include('profile').limit(1).exec() —— where、include、limit 都只设内部参数并 return this，exec 才发起请求并返回 Promise
合理分离构建态与执行态
服务层链式调用本质是“构建查询/操作描述 + 最终执行”，CommonJS 模块需清晰划分这两阶段：
立即学习“Java免费学习笔记（深入）”；
- 构建阶段方法（如 where、sort、select）仅修改内部 options 对象，不触发 I/O
- 执行阶段方法（如 .run()、.first()、.toArray()）才调用底层 fs.readFile、axios.get 等，并返回 Promise
- 这样既保持链式流畅，又符合 Node.js 非阻塞原则，避免同步 I/O 打断事件循环
注意 CommonJS 缓存与状态共享风险
require() 缓存机制意味着多次引入同一模块会得到同一个对象实例。若服务模块内部维护了状态（如默认 headers、baseURL、token），可能引发意外共享：
- 解决方案一：模块默认导出工厂函数，每次调用生成新实例
- 解决方案二：在构造时清空或初始化关键状态字段，避免跨请求污染
- 不建议在 module.exports 对象上直接挂载可变状态（如 this.cache = {}），尤其在 Web Server 场景下易引发并发问题
