一、问题背景:Python调用JS文件,突然报const错误
在Python爬虫开发过程中,有时会遇到一种比较特殊的情况:
明明从浏览器开发者工具中复制出来的JavaScript代码,在浏览器控制台中可以正常运行,但是放到Python项目中执行,却出现了语法错误。
例如:
SyntaxError: Unexpected token 'const'
或者:
SyntaxError: invalid syntax
刚开始可能会怀疑是不是JS代码复制不完整,或者某个变量没有定义。
但检查代码后发现,问题可能并不在JS代码本身,而是当前执行JavaScript的环境不支持对应的语法,或者根本没有使用JavaScript运行环境。
这个问题在爬虫开发中比较常见。
例如:
- 调用JavaScript文件生成接口请求参数;
- 执行网页中的加密算法;
- 处理动态生成的签名参数;
- 将浏览器中的部分JS逻辑移植到Python项目;
- Python调用外部JS脚本完成数据处理。
本文就从实际开发角度,介绍const报错的原因以及几种解决方法。
二、为什么会出现const报错?
首先需要了解一个概念:Python和JavaScript是两种不同的编程语言。
Python解释器不能直接执行JavaScript代码。
例如下面这段JS代码:
const name = "Python";
const age = 18;
console.log(name);
console.log(age);
其中的const是JavaScript ES6(ECMAScript 2015)引入的变量声明关键字,用于声明不可重新赋值的变量。
如果直接把这段代码放进Python文件中运行:
const name = "Python"
print(name)
就会出现Python语法错误。
因为Python并不认识JavaScript中的const。
那么,为什么有时候明明使用了JavaScript执行工具,仍然会提示:
SyntaxError: Unexpected token 'const'
通常有以下几种原因。
1. 使用了不支持ES6语法的JavaScript运行环境
JavaScript早期版本主要使用var声明变量。
后来ES6增加了let、const、箭头函数、模板字符串等语法特性。
如果使用的JavaScript运行引擎版本比较老,就可能无法识别这些新语法。
例如:
const a = 10;
console.log(a);
在支持ES6的现代JavaScript环境中可以正常执行。
但在某些旧版JS引擎中,可能直接报错。
2. Python调用JS时,实际使用的不是Node.js
有些Python项目会使用第三方库执行JavaScript。
例如:
- PyExecJS
- Js2Py
- 其他JavaScript解释器或运行时封装工具
这些工具的底层实现并不完全相同。
有些依赖系统中的JavaScript运行环境,有些则通过Python实现部分JavaScript语法。
如果运行环境不支持当前JS代码中的语法,就可能出现const报错。
3. JS代码本身使用了模块化语法
除了const之外,JavaScript还存在CommonJS和ES Module两种常见模块体系。
例如:
import crypto from "crypto";
const result = "hello";
export default result;
如果当前执行环境按照CommonJS方式加载,却直接运行ES Module代码,也可能出现模块语法相关错误。
因此,遇到报错时,不要只盯着const,还需要检查整个JS文件使用的语法规范。
三、解决方案一:使用Node.js执行JS文件(推荐)
这是我比较推荐的方式。
Node.js本身就是一个JavaScript运行环境,可以在服务器或本地直接执行JS文件。
它对现代JavaScript语法支持比较完善,也可以使用Node.js自带的加密、文件和网络模块。
第一步:安装Node.js
先到Node.js官方网站下载安装包:
建议选择当前仍受支持的LTS版本。
安装完成后,打开终端执行:
node -v
如果正常输出版本号,例如:
v22.x.x
说明Node.js已经安装成功。
再执行:
npm -v
可以检查npm是否正常安装。
第二步:创建JS文件
新建一个文件,命名为:
test.js
写入以下代码:
const name = "Python";
const age = 18;
function getInfo() {
return `${
name} is ${
age} years old`;
}
console.log(getInfo());
在终端中执行:
node test.js
正常情况下会输出:
Python is 18 years old
这说明JS文件已经可以通过Node.js正常执行。
第三步:使用Python调用JS文件
接下来重点来了。
Python可以通过内置的subprocess模块启动Node.js进程,从而执行JS文件。
示例代码:
import subprocess
js_file = "test.js"
result = subprocess.run(
["node", js_file],
capture_output=True,
text=True,
encoding="utf-8",
timeout=15
)
print("JS执行结果:")
print(result.stdout)
if result.stderr:
print("错误信息:")
print(result.stderr)
运行Python文件后,就可以看到JS程序输出的结果。
这里几个参数需要了解一下:
| 参数 | 作用 |
|---|---|
| capture_output=True | 捕获标准输出和错误输出 |
| text=True | 将输出按文本形式处理 |
| encoding="utf-8" | 指定文本编码 |
| timeout=15 | 设置执行超时时间 |
这种方式最大的优点是:
Python负责业务流程,Node.js负责执行JavaScript,两者通过标准输入和输出交换数据。
对于需要调用JS加密算法的爬虫项目,这种方式比较实用。
四、解决方案二:使用PyExecJS调用JavaScript
如果项目中已经使用了PyExecJS,也可以继续采用这种方式。
PyExecJS是一个用于从Python调用JavaScript代码的工具,它可以连接外部JavaScript运行环境。
1. 安装依赖
执行:
pip install PyExecJS
同时确保系统已经安装Node.js等可用的JavaScript运行环境。
2. 编写JavaScript代码
创建一个文件:
calculate.js
内容如下:
function add(a, b) {
const result = a + b;
return result;
}
3. Python调用JS函数
import execjs
with open("calculate.js", "r", encoding="utf-8") as f:
js_code = f.read()
ctx = execjs.compile(js_code)
result = ctx.call("add", 10, 20)
print(result)
输出:
30
这种方式不需要自己手动编写subprocess调用逻辑,使用起来比较简单。
不过需要注意:
PyExecJS本身不是独立的JavaScript引擎,实际执行能力取决于它调用的运行环境。
另外,它属于较老的集成方案,对于新的项目,如果需要使用较多现代JS特性或Node.js模块,我更建议直接使用Node.js配合subprocess。
五、解决方案三:使用Js2Py执行简单JS代码
还有一种方案是Js2Py。
它是一个基于Python实现的JavaScript解释器,可以将部分JavaScript代码转换并执行。
安装方式:
pip install js2py
示例:
import js2py
js_code = """
var a = 10;
var b = 20;
function add(x, y) {
return x + y;
}
"""
context = js2py.EvalJs()
context.execute(js_code)
result = context.add(10, 20)
print(result)
输出:
30
需要注意的是,Js2Py对JavaScript语法的支持存在限制,不能简单认为它能够完整执行现代JavaScript代码。
如果JS文件中包含const、let、async/await、ES Module或者复杂的Node.js模块依赖,可能需要调整代码或更换运行环境。
因此,它更适合执行一些简单的JavaScript逻辑,不建议作为复杂爬虫项目的首选方案。
六、三种解决方案应该怎么选?
上面介绍了三种常见方案,可以简单对比一下:
| 方案 | 是否需要Node.js | JS兼容能力 | 适合场景 |
|---|---|---|---|
| Node.js + subprocess | 需要 | 较完整 | 现代JS、爬虫、加密算法 |
| PyExecJS | 需要可用JS运行环境 | 取决于底层运行时 | 简单调用JS函数 |
| Js2Py | 不需要 | 有一定限制 | 简单JS代码执行 |
如果只是为了快速解决const报错,建议优先检查当前JavaScript运行环境。
如果项目本身就需要长期调用JS文件,直接使用Node.js通常更加省心。
七、进阶:Python如何向JS传递参数并获取返回结果?
在实际爬虫项目中,往往不是简单地执行一段JS代码就结束了。
更常见的需求是:
Python获取请求参数,然后传递给JS进行计算,最后再将JS生成的结果返回给Python。
例如,Python传递一个字符串,JS负责处理后返回结果。
1. 编写JS文件
创建:
sign.js
内容:
const crypto = require("crypto");
const input = process.argv[2] || "";
const result = crypto
.createHash("sha256")
.update(input)
.digest("hex");
console.log(result);
这里使用Node.js自带的crypto模块计算SHA256摘要。
2. Python传递参数并接收结果
import subprocess
def run_js(value):
result = subprocess.run(
["node", "sign.js", value],
capture_output=True,
text=True,
encoding="utf-8",
timeout=15,
check=True
)
return result.stdout.strip()
data = "hello python"
sign = run_js(data)
print("原始数据:", data)
print("JS计算结果:", sign)
这样就实现了:
Python传递参数
|
v
启动Node.js
|
v
执行JavaScript
|
v
返回计算结果
|
v
Python接收结果
这种方式在爬虫开发中非常实用。
例如,某些公开接口需要按照指定规则生成参数,可以将相关计算逻辑放在JS文件中,由Python负责调用接口和处理返回数据。
需要注意,示例中的SHA256只是演示Python与JS之间的数据传递,并不代表任何具体网站的签名算法。
八、实际开发中还需要注意哪些问题?
解决const报错后,可能还会遇到其他问题。
这里整理几个比较常见的情况。
1. 提示node不是内部或外部命令
例如:
'node' 不是内部或外部命令,也不是可运行的程序
说明系统没有找到Node.js执行程序。
检查方法:
node -v
如果仍然无法识别,需要检查Node.js是否安装成功,以及安装目录是否加入系统PATH环境变量。
2. 提示Cannot use import statement outside a module
这通常与JavaScript模块类型有关。
如果使用的是ES Module语法:
import crypto from "crypto";
可以根据项目情况采用以下方式之一:
- 将文件扩展名改为
.mjs; - 在项目的package.json中设置
"type": "module"; - 将代码调整为CommonJS语法。
例如:
const crypto = require("crypto");
3. JS文件中使用了window或document
有些JS代码是从浏览器开发者工具中复制出来的。
这类代码可能依赖浏览器环境,例如:
const title = document.title;
console.log(title);
直接使用Node.js运行就会报错:
ReferenceError: document is not defined
原因是Node.js不是浏览器,没有浏览器DOM环境。
如果代码确实依赖网页DOM、浏览器Cookie或页面运行状态,就需要使用浏览器自动化环境,例如Playwright或Puppeteer,而不是单纯更换Node.js版本。
4. JS执行超时
如果JS代码中包含复杂计算、循环或者异步操作,也可能出现执行时间过长的问题。
可以在Python中设置timeout:
subprocess.run(
["node", "test.js"],
capture_output=True,
text=True,
timeout=10
)
另外,如果JS程序使用了异步操作,需要确保主程序正确等待异步任务完成后再退出。
九、总结
Python运行JavaScript文件时出现const报错,核心原因通常不是const本身有问题,而是当前执行环境无法正确识别JavaScript语法。
遇到这类问题,建议按照以下顺序排查:
- 确认当前执行的是Python代码还是JavaScript代码;
- 检查使用的JavaScript运行环境;
- 确认运行环境是否支持ES6语法;
- 检查JS文件是否使用了ES Module等模块语法;
- 检查代码是否依赖浏览器环境;
- 根据项目需求选择合适的执行方式。
如果是Python爬虫项目,需要长期调用JavaScript代码,我个人更推荐:
Python + Node.js + subprocess。
Python负责请求调度、数据处理和结果保存,Node.js负责执行JavaScript逻辑。
两种语言各自发挥优势,通过参数和标准输出完成数据交互,整体结构清晰,也便于后期维护。
对于需要处理JavaScript动态参数、加密计算以及复杂网页逻辑的爬虫项目,这是一种值得掌握的开发方式。