@browserless/goto

@ browserless/goto: 转到一个页面中止不必要的请求 .

见 转到区域 详情请见我们的网站.

安装

使用 npm :

npm install @browserless/goto --save

关于

此软件包提供 高级页面导航 内置广告屏蔽 智能等待策略 以及广泛的定制选项 它是所有无浏览器页面加载操作的核心导航引擎.

这个软件包做什么

这个 @browserless/goto 软件包允许您 :

• 导航到页面 具有优化装载和智能等待策略
• 块状广告和跟踪器 使用预编成的 Ghostery 广告屏蔽引擎
• 注入脚本、模块和样式 输入页面
• 模拟设备 带有视图、用户代理和媒体特性
• 拦截和中止请求 按资源类型
• 处理 cookie 和 HTTP 认证

使用量

const createGoto = require('@browserless/goto')
const puppeteer = require('puppeteer')

const goto = createGoto({ 
  timeout: 30000,
  defaultDevice: 'Macbook Pro 13'
})

const browser = await puppeteer.launch()
const page = await browser.newPage()

const { response, device, error } = await goto(page, {
  url: 'https://example.com',
  adblock: true,
  waitUntil: 'auto'
})

选项

聪明的等待 waitUntil: 'auto'

默认 'auto' 模式 智能等待页面准备 :

// Auto mode combines 'load' with 'networkidle2' smartly
await goto(page, { url: 'https://example.com', waitUntil: 'auto' })

// Standard Puppeteer wait conditions also supported
await goto(page, { url: 'https://example.com', waitUntil: 'networkidle0' })
await goto(page, { url: 'https://example.com', waitUntil: ['load', 'domcontentloaded'] })

内建的Ad 屏蔽器

包包括一个预编译 幽灵广告屏蔽器 自动屏蔽广告和跟踪器的引擎:

// Enabled by default
await goto(page, { url: 'https://example.com', adblock: true })

// Disable for specific pages
await goto(page, { url: 'https://example.com', adblock: false })

// The adblocker can be disabled mid-session
page.disableAdblock()

Cookie 同意处理(选择退出)列为 adblock: true 和动力 duckuckgo/自动同意。 。 。 .

adblock: true 也排除了非自动同意的通用公告对话框: ARIA 对话框(role="dialog", (中文(简体) ), role="alertdialog", (中文(简体) ), aria-modal, (中文(简体) ), <dialog open>),没有同意语言和单一的承认式按钮("我理解","得到它","OK",或一个 aria-label="close" 按钮)。 包含窗体字段的对话框不受影响,除非它们暴露出一个明显的关闭按钮,并且仅 <button> 元素被点击 所以解职永远无法导航。 它还包括了不具有对话作用的通知/推入选择上覆,例如AliExpress在标题上所制作的上覆:这些上覆只在副本涉及通知时才被点击,上覆坐落在一个位置小于取景口的容器中,它没有表单字段,也没有同意语言,它暴露出一种明确否定的控制("现在不是","没有许可证","尼赫特喷射",a aria-label="close" (b) 支付)。 肯定控制("Allow","Permitir")从未被点击过,链接中的控制被跳过,因此解职无法导航.

通知

通知默认被拒绝,所以网站跳过它们为索取而提供的覆盖. Notification.permission 财务报告和审定财务报表 navigator.permissions.query({ name: 'notifications' }) 都读 denied,用于屏蔽通知的用户的Chrome对数值报告 window.Notification 继续暴露在克罗姆的体内.

权限属于页面浏览器的上下文,并应用在每次导航上,因此共享上下文的页面共享该值,且不使用 goto 保持克罗姆的默认值.

// denied (default)
await goto(page, { url: 'https://example.com' })

// Chrome's out-of-the-box state, where `Notification.permission` reads `default`
await goto(page, { url: 'https://example.com', notifications: true })

脚本和样式注入

注入外部资源或内入代码 :

await goto(page, {
  url: 'https://example.com',
  // External URLs
  scripts: ['https://cdn.example.com/library.js'],
  // ES modules
  modules: ['https://cdn.example.com/module.mjs'],
  // CSS (URLs, paths, or inline)
  styles: [
    'https://cdn.example.com/styles.css',
    'body { background: red; }'
  ]
})

请求拦截

中止特定资源类型以加快导航 :

await goto(page, {
  url: 'https://example.com',
  abortTypes: ['image', 'stylesheet', 'font', 'media'],
  onPageRequest: (request, page) => {
    console.log('Request:', request.url())
  }
})

设备仿真

// Use preset device
await goto(page, { url: 'https://example.com', device: 'iPhone 13' })

// Custom viewport
await goto(page, {
  url: 'https://example.com',
  viewport: { width: 1920, height: 1080 }
})

// Custom headers
await goto(page, {
  url: 'https://example.com',
  headers: {
    'user-agent': 'custom-agent',
    'cookie': 'session=abc123'
  }
})

返回值

这个 goto 函数返回 :

const { response, device, error } = await goto(page, { url })

// response: Puppeteer Response object (or undefined if navigation failed)
// device: { userAgent, viewport } used for the request
// error: Error object if navigation failed

如何适合在单体

这是 核心导航引擎 用于整个无浏览器生态系统:

依赖关系

许可证

@ 浏览器无/去 © 微链接,在 麻省理工学院 执照.
作者和维护者 微链接 由来自 捐助者。 。 。 .

这个 标志 设计由 辛赫工作室。 。 。 .

微链接.io • GitHub 软件 微链克 • X @microlinkhq (英语)