简介

该模块可以使SPA(单页应用)在不使用服务端渲染框架的情况下，使搜索引擎蜘蛛在爬取页面时，返回js执行过后的页面，而在用户访问时则直接原样返回，以此来改善SPA的SEO。

你可以把这个模块当做node.js版本的rendora，原理也是相同的。

该模块通过运行一个代理服务及无头模式(headless mode)的浏览器，匹配指定的url或user-agent请求头，匹配的url返回无头浏览器加载后的结果。对于不匹配的url，则只是一个透明的代理，不做任何事情。

安装

yarn add robot-waiter
npm i robot-waiter

robot-waiter中使用了Puppeteer，在安装时会同时安装和Puppeteer配套使用的Chromium (~170MB Mac, ~282MB Linux, ~280MB Win)，如需了解详情以及如何使用自定义浏览器渲染，请参考Puppeteer官网首页的Installation章节。

因为安装Puppeteer时会下载Chromium，请耐心等待(尤其是国内，速度会相对较慢)。

一些Linux的OS可能会缺少部分依赖库，运行时会报错，请根据错误提示安装对应的依赖库文件。

例子

import robotWaiter from 'robot-waiter'
// 假设一个SPA跑在http://localhost:8080上

robotWaiter({
  port: 8001    // robot-waiter代理服务的端口
  targetUrl: 'http://localhost:8080'   // 要代理的url
})

参数

interface RobotWaiterConfig {
  port?: number
  targetUrl: string
  wait?: number

  filters?: {
    paths?: (string | RegExp)[]
    userAgent?: string[]
  }
}

• port: robot-waiter的服务端口。默认值：9010
• targetUrl: 要代理的url，如果要代理的目标部署在同一台服务器上，应该使用本地url而不是网络url，以免造成额外的性能损失。
• wait: 匹配的页面在浏览器中从加载开始要等待的时间，单位为毫秒。时间过短有可能页面还未加载完毕就返回结果，过长则拖慢请求的响应时间(影响的只是搜索引擎蜘蛛，不会拖慢用户访问的响应时间)。默认值：3000
• filters: 过滤选项。
  • paths: 由字符串或正则表达式组成的数组，与这些字符串或正则匹配的路径(路径不包括baseUrl，baseUrl一般等同于传入的targetUrl)，将返回js执行过后的页面。默认值：[]。
  • userAgent: 由字符串组成的数组，接收到的请求头user-agent字段中包含这些字符串其中之一的，将返回js执行过后的页面。默认值：[ 'bot', 'bing', 'yandex', 'slurp', 'duckduckgo', 'baiduspider', 'googlebot', '360spider', 'sosospider', 'sogou spider' ]