当前位置：首页 > news >正文

SlimerJS API深度探索：phantom、webpage、system模块详解

news 2026/5/27 2:28:15

SlimerJS API深度探索：phantom、webpage、system模块详解

【免费下载链接】slimerjsA scriptable browser like PhantomJS, based on Firefox项目地址: https://gitcode.com/gh_mirrors/sl/slimerjs

SlimerJS是一款基于Firefox的脚本化浏览器，提供了强大的API让开发者能够自动化网页操作、截图生成和网络监控等任务。本文将深入解析SlimerJS核心的phantom、webpage和system模块，帮助你快速掌握这些工具的使用方法。

一、phantom模块：全局控制中心

phantom模块是SlimerJS的全局控制核心，提供了浏览器实例的基础配置和系统级操作能力。

1.1 核心功能与属性

Cookie管理：通过phantom.cookies数组和phantom.deleteCookie()方法实现Cookie的增删改查。例如：
```
// 设置Cookie phantom.cookies = [{ name: 'test', value: '123', domain: 'example.com' }]; // 清除所有Cookie phantom.clearCookies();
```
相关测试代码可见test/test-phantom-cookies.js。
代理配置：使用phantom.setProxy()灵活设置网络代理，支持HTTP、SOCKS等协议：
```
// 配置HTTP代理 phantom.setProxy('127.0.0.1', 8080, 'http');
```
详细实现参考test/test-proxy.js。

版本信息：通过phantom.version获取当前SlimerJS版本：

console.log(`SlimerJS v${phantom.version.major}.${phantom.version.minor}`);

二、webpage模块：网页交互引擎

webpage模块是SlimerJS的核心功能模块，负责网页加载、渲染和交互操作，是实现自动化测试和网页截图的关键。

2.1 网页渲染与截图

webpage模块最强大的功能之一是网页渲染与截图。通过render()方法可以将网页保存为图片或PDF，支持多种分辨率和缩放比例。

SlimerJS渲染的高分辨率网页截图（1600x800像素）

以下是基础截图代码示例：

var page = require('webpage').create(); page.open('http://example.com', function(status) { if (status === 'success') { // 保存截图 page.render('example.png'); phantom.exit(); } });

2.2 事件监听与交互

webpage支持丰富的事件监听，如页面加载、资源请求、控制台输出等：

onLoadFinished：页面加载完成触发
onResourceRequested：资源请求时触发
onConsoleMessage：捕获页面控制台输出

page.onConsoleMessage = function(msg) { console.log('Page console:', msg); };

2.3 页面操作API

键盘事件：通过sendEvent()模拟键盘输入：
```
page.sendEvent('keypress', page.event.key.A);
```
测试案例见test/test-webpage-keyevent-phantom.js。

鼠标操作：支持点击、拖拽等鼠标事件：

page.sendEvent('click', 100, 200); // 点击坐标(100,200)

三、system模块：系统环境交互

system模块提供了与操作系统交互的能力，包括命令行参数、环境变量和系统信息获取。

3.1 命令行参数处理

通过system.args获取命令行参数，轻松实现脚本的灵活配置：

if (system.args.length > 1) { var url = system.args[1]; // 获取第一个参数作为URL }

示例代码参考examples/phantomjs/loadspeed.js。

3.2 系统信息获取

操作系统信息：通过system.os获取系统详情：

console.log('OS:', system.os.name, system.os.version); console.log('Architecture:', system.os.architecture);

环境变量：访问system.env获取环境变量：
```
console.log('Home directory:', system.env.HOME);
```
相关测试见test/test-system.js。

3.3 标准输入输出

system.stdout.write()：标准输出
system.stderr.write()：错误输出

system.stdout.write('Processing...'); system.stderr.write('Warning: Low memory');

四、模块协同应用示例

下面展示一个综合运用三个模块的示例，实现网页加载、截图并输出系统信息：

var page = require('webpage').create(); var system = require('system'); // 从命令行获取URL参数 var url = system.args[1] || 'http://example.com'; page.open(url, function(status) { if (status === 'success') { // 渲染网页 page.render('output.png'); // 输出系统信息 console.log('OS:', system.os.name); console.log('Screenshot saved as output.png'); } phantom.exit(); });