写浏览器自动化脚本时,最容易出问题的地方往往不是"不会调用接口",而是"没等到真正完成就往下走了"。比如上传图片,页面显示上传中,脚本已经开始点发布;读配置还没结束,就先去用了空值。Node 里处理这件事的主线,就是从回调走到 Promise,再走到 async/await。
本机环境记录:Windows,Node v22.22.2。下面示例只用标准库 node:fs/promises 和原生 fetch,不装额外依赖。
先看一个回调写法:
js
const fs = require('node:fs');
fs.readFile('config.json', 'utf8', (err, text) => {
if (err) {
console.error('读取失败', err);
return;
}
const config = JSON.parse(text);
console.log(config);
});
这段代码能跑,但一旦后面再加一步"读取标题清单",就会变成回调套回调。错误处理也会散落在每一层里,最后很难判断哪一步失败了。
改成 Promise 之后,逻辑会平一些:
js
import { readFile } from 'node:fs/promises';
function readJson(file) {
return readFile(file, 'utf8').then((text) => JSON.parse(text));
}
readJson('config.json')
.then((config) => {
console.log('配置已读取', config);
})
.catch((err) => {
console.error('读取或解析失败', err.message);
});
这里的关键不是少写几行,而是错误有了统一出口。readFile 失败和 JSON.parse 失败都会进同一个 catch,调用方不必每层都处理。
再进一步,用 async/await:
js
import { readFile } from 'node:fs/promises';
async function readJson(file) {
const text = await readFile(file, 'utf8');
return JSON.parse(text);
}
async function main() {
try {
const config = await readJson('config.json');
const titles = await readJson('titles.json');
console.log('配置:', config);
console.log('标题数量:', titles.length);
} catch (err) {
console.error('初始化失败:', err.message);
process.exitCode = 1;
}
}
main();
这版最接近真实脚本。它把"读取配置"和"读取标题"写成两个等待点,每一步都清楚;任何一个失败都进外层 catch,并设置退出码,方便定时任务判断成败。
并发场景可以用 Promise.all:
js
async function loadAll(files) {
const results = await Promise.all(
files.map((file) => readJson(file))
);
return results;
}
但 Promise.all 有一个容易忽略的点:任何一个 Promise 失败,整体立刻失败,其他任务不会自动取消。如果那些任务已经产生副作用,比如写入临时文件或调用外部接口,就要自己处理清理逻辑。不是为了"快"就无脑并发。
真正让我改掉习惯的,是三种常见坑。
第一,忘记 await。const data = readJson('config.json') 拿到的是 Promise,不是数据;后面直接 data.title 一定是 undefined。解决不是到处补 await,而是让函数职责清楚:异步函数返回 Promise,调用方负责等待。
第二,catch 里只打印不处理。调试阶段可以打印,但脚本里最好同时设置 process.exitCode,否则失败也会被定时任务当成功。真实自动化里,"失败但退出码为 0"是最容易骗过监控的情况。
第三,把等待当成延时。有人用 setTimeout(3000) 代替等待上传完成,网络慢时不够,网络快时浪费时间。更好的方式是等明确信号:页面状态、接口返回、文件存在、状态字段变化。延时只能兜底,不能当主逻辑。
如果后面加 AI 优化,我会先让它检查这类问题:有没有漏 await、有没有吞掉错误、并发失败时是否会留下半成品。但提示词再好,也只能做审查建议;结论必须回到本机脚本里跑过,再写进记录。
一句话收尾:Promise 解决的是"结果什么时候来",async/await 解决的是"代码按什么顺序读";真正稳定的是每一步都有明确成功、失败和超时边界。