nightmare API

nightmare API 简单介绍

2016-04-18

nightmare 的 API 不是特别的多，平常使用比较多的主要是配置 nightmare 以及与页面交互的相关API，这里是官方给出的 nightmare 文档可以参考学习。

API	描述
Nightmare(options)	初始化实例，options 为设置 Electron 浏览窗口的配置，参考文档
waitTimeout (default: 30s)	wait 等待最长时间，超过这个时间还未返回，则抛出异常
paths	为 Electron 设置数据路径，参考文档
switches	chrome 的一些配置，参考文档

与页面交互API

API	描述
.goto(url)	加载 url 页面
.back()	后退到前一页
.forward()	前进到下一页
.refresh()	刷新当前页
.click(selector)	点击selector元素
.mousedown(selector)	鼠标按下selector元素
.type(selector [, text])	如果有text参数，则向 selector 输入 text，否则清空 selector , 并触发键盘事件
.insert(selector [, text])	与type功能一致，但是不触发键盘事件，输入速度快于.type
.check(selector)	选中 selector checkbox
.uncheck(selector)	取消选中 selector checkbox
.select(selector,option)	选中 dropdown 的option选项
.scrollTo(top, left)	屏幕滚动
.viewport(width, height)	调整视窗大小
.inject(type, file)	注入本地的 js、css 文件
.evaluate(fn[, arg1, arg2])	在页面中执行fn
.wait(ms \| selector \| fn)	等待ms秒, 等待 selector, 等待 fn
.exists(selector)	selector 是否存在
.visible(selector)	selector 是否是可见的
.on(event, callback)	捕获页面上的事件
.title()	返回当前页面的title
.url()	返回当前页面的url
.screenshot()	截图

上面的 API 都是与页面之间进行交互，其中有几个方法比较特别，将进一步对其介绍。

nightmare 的 .evaluate() 方法

evaluate(fn[, arg1, arg2 …]) 方法是在浏览器端执行 fn 函数，因此对 dom 节点的一些读写操作要使用 evaluate() 方法才行。

var Nightmare = require('nightmare');
var nightmare = new Nightmare({ show: true });
var content;
nightmare.goto('https://example.com').evaluate(function(selector){return document.querySelector(selector).textContent; // 返回dom节点信息}, '.head').then(function(res) {console.log(res); // 打印返回的节点信息});

要注意以下几点：首先，evaluate() 方法是在浏览器端执行 fn 函数，也就是说 fn 函数的执行环境是浏览器环境，而不是 node 环境，因此一些浏览器不支持的 ES6 特性，在 fn 函数中不要使用其次，浏览器中的dom信息只能通过fn的返回值来获得，而提供给fn使用的数据只能通过参数传递，也就是说不要使用全局变量的方式进行数据传递

例如：

var Nightmare = require('nightmare'),nightmare = new Nightmare({ show: true }),content,                // Aselector = '.head';     // Bnightmare.goto('https://example.com').evaluate(function(selector) {let msg = 'test'; // 浏览器不支持的特性, 错误content = document.querySelector(selector).textContent; // 使用 A, B 处定义的变量，错误}).then();

关于evaluate() 的坑

nightmare 的 .wait() 方法

wait() 方法的作用是等待某个事件发生，这些事件包括：一段时间结束、等待某个dom元素出现、等待某个函数执行完成。wait(fn) 方法与 evaluate(fn) 方法类似，fn 也是要在浏览器上执行，但是最后要返回 true 才能结束等待，最长的等待时间为 waitTimeout 设置的时长。

var Nightmare = require('nightmare');
var nightmare = Nightmare({ show: true });nightmare.goto('https://baidu.com').wait(function() {// 在 baidu 的页面中绑定一个 dom 节点var ndTest = document.createElement('p');ndTest.innerHTML = 'This is test for nightmare\'s wait';ndTest.className = 'test';document.body.appendChild(ndTest);return true;}).wait('.test').evaluate(function() {// 返回节点文本信息return document.querySelector('.test').textContent;}).then(function(res) {console.log(res);});

nightmare 的 .insert() 与 .type() 方法

两者都能向 web 页面的输入框输入信息，但是存在着一些差别。type() 再输入过程中触发键盘事件，而 insert() 不触发键盘事件，但是insert() 输入的速度要快一些。因此如果输入框要响应键盘输入的事件，这时就要 type()了。

总结

主要介绍 nightmare 的 API，nightmare 的配置参数主要分为三个方面：Electron 配置参数（nightmare 的底层是 Electron 框架）、Chrome 配置参数（Electron 使用了 Chrome 浏览器）以及自身的配置。nightmare 与外面的交互 API 可以分为两类：其一，操作类 API 如 wait、click、evaluate 等；其二，输出结果 API 如 title、exists 等。使用时最值得注意的就是 evaluate()，很容易出错。

转载于:https://www.cnblogs.com/developer-ios/p/11193808.html

nightmare API相关推荐

如何从XMLHttpRequest创建自定义获取API
What is your worst nightmare? 你最可怕的噩梦是什么? That sounded dark, but it's not a rhetorical question. I r ...
带有serpstack的实时Google搜索结果API
SERP stands for Search Engine Results Page. serpstack is an API that queries the result page of sear ...
恶梦护士 asa_噩梦就是JSON日期。另外，JSON.NET和ASP.NET Web API
恶梦护士 asa Ints are easy. Strings are mostly easy. Dates? A nightmare. They always will be. There's di ...
自动化测试（二）02——单元测试类工具-Karma、Jasmine、Mocha、Jest、AVA E2E测试类工具-cypress、nightmare、nightwatch、testcafe
自动化测试(二)02--单元测试类工具-Karma.Jasmine.Mocha.Jest.AVA & E2E测试类工具-cypress.nightmare.nightwatch.testcaf ...
淘宝获取单笔订单信息服务端调用API及流程
淘宝获取单笔交易接口(文档地址):https://open.taobao.com/api.htm?docId=54&docType=2 调用接口所需依赖(文档地址):https://devel ...
rancher部署项目Validation failed in API: Deployment.apps“”must be no more than 63 characters问题原因及解决方法
Validation failed in API: Deployment.apps "xxxxxxxxxx-x x x x x x x x x" is invalid: [meta ...
RPC 笔记（01）— RPC概念、调用流程、RPC 与 Restful API 区别
1. 基本概念 PRC 远程过程调用 Remote Procedure Call,其就是一个节点请求另外一个节点提供的服务.当两个物理分离的子系统需要建立逻辑上的关联时,RPC 是牵线搭桥的常见技术手 ...
通过聚合数据API获取微信精选文章
思路在聚合数据申请账号(https://www.juhe.cn/) 通过聚合数据api获取微信精选文章api 通过newspaper库提取相应的文本内容,关于newspaper库的使用方法可以参考这 ...
使用 JavaCSV api 读取和写入 csv 文件
使用JavaCSV api 导包我现在基本上都是Maven构建项目,相信大家也是,就不提供jar包了. <dependency><groupId>net.sourceforg ...
API pytorch tensorflow
pytorch与tensorflow API速查表方法名称 pytroch tensorflow numpy 裁剪 torch.clamp(x, min, max) tf.clip_by_value ...

nightmare API

nightmare API 简单介绍

相关配置 API

与页面交互API

总结

nightmare API相关推荐

最新文章

热门文章