深入解析phantomjs-node中的Phantom对象API-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01162/article/details/148575823

深入解析phantomjs-node中的Phantom对象API

phantomjs-node PhantomJS integration module for NodeJS 项目地址: https://gitcode.com/gh_mirrors/ph/phantomjs-node

前言

phantomjs-node是一个强大的Node.js模块，它提供了对PhantomJS无头浏览器的封装。本文将重点介绍其核心Phantom对象的API使用方法，帮助开发者更好地掌握这个工具。

Phantom对象创建

创建Phantom实例是整个操作的起点，使用phantom.create()方法会返回一个Promise，该Promise解析后会得到一个Phantom对象。

基本创建方式

const phantom = require('phantom');

phantom.create().then(instance => {
  // 使用Phantom实例
});

高级配置选项

创建时可以传入PhantomJS进程参数和配置对象：

phantom.create([
  '--ignore-ssl-errors=yes',  // 忽略SSL错误
  '--load-images=no'          // 不加载图片以提高性能
], {
  phantomPath: '/custom/path/to/phantomjs',  // 自定义PhantomJS路径
  shimPath: '/custom/path/to/shim.js',      // 自定义shim文件路径
  logger: customLogger,                     // 自定义日志记录器
  logLevel: 'debug'                         // 日志级别
}).then(instance => {
  // 使用配置好的实例
});

页面管理

创建新页面

在获得Phantom实例后，可以创建页面对象：

let phantomInstance;

phantom.create()
  .then(instance => {
    phantomInstance = instance;
    return instance.createPage();  // 创建页面
  })
  .then(page => {
    // 使用page对象进行各种操作
  })
  .catch(err => {
    console.error('发生错误:', err);
    phantomInstance.exit();  // 确保退出
  });

进程管理

优雅退出

使用exit()方法可以正常关闭PhantomJS进程：

phantomInstance.exit()
  .then(() => console.log('PhantomJS已关闭'))
  .catch(err => console.error('关闭失败:', err));

强制终止

在需要立即终止时，可以使用kill()方法：

process.on('SIGTERM', () => {
  phantomInstance.kill();  // 强制终止进程
});

process.on('SIGINT', () => {
  phantomInstance.kill();  // 处理Ctrl+C中断
});

注意：如果Node进程收到SIGKILL信号，PhantomJS进程可能会变成僵尸进程。

日志系统

内置日志配置

phantomjs-node使用winston日志系统，可以通过配置对象进行定制：

// 只记录错误级别日志
phantom.create([], { logLevel: 'error' })
  .then(ph => {
    // ph.logger可以访问日志对象
  });

自定义日志

可以完全替换默认日志系统：

const customLogger = {
  debug: () => {},           // 禁用debug日志
  info: console.log,         // info级别输出到控制台
  warn: console.warn,        // warn级别输出到控制台
  error: console.error       // error级别输出到控制台
};

phantom.create([], { logger: customLogger })
  .then(ph => {
    // 使用自定义日志
  });