Puppeteer / Chrome DevTools协议:有没有一种方法可以触发标准缩放(并非无头)

时间:2019-09-05 09:23:04

标签: puppeteer chrome-devtools-protocol

我正在关闭无头模式的情况下运行puppeteer,以便自动执行并远程控制另一台计算机上可见的Chromium浏览器。

是否有一种方法可以像在UI菜单或ctrl + / crtl -命令中一样在浏览器上触发或模拟缩放?

注入CSS或使用各种文档化的scale命令不能完全复制此代码,例如,使用vh / vw单位定义的元素不会得到调整。


我当前的解决方案

Emulation.setDeviceMetricsOverride中使用视口缩放比例可以很好地进行缩小,但是似乎正在调整页面栅格的大小,而不是按照目标大小进行渲染,从而导致放大时文本模糊。

调整视口大小并使用Emulation.setPageScaleFactor可以很好地放大,但是在我的测试中似乎忽略了小于1的pageScaleFactor。

这两种解决方案的一个问题是,它需要事先知道浏览器窗口的宽度/高度,并依赖于这种不变/不变的视口,而不是拥有流畅的视口。我也不确定我是否缺少标准浏览器缩放功能的其他功能。

我的缩放代码现在为:


async applyFrameZoom(page, zoom) {
    // page is a puppeteer.Page instance
    // zoom is an integer percentage

    const session = await page.target().createCDPSession();

    let window = await session.send('Browser.getWindowForTarget', {
        targetId: page.target()._targetId
    });

    let width = window.bounds.width;
    let height = window.bounds.height;

    if (!zoom || zoom === 100) {
        // Unset any zoom
        await session.send('Emulation.clearDeviceMetricsOverride');
        await session.send('Emulation.resetPageScaleFactor');
    } else if (zoom > 100) {
        // Unset other zooming method
        await session.send('Emulation.clearDeviceMetricsOverride');

        // Zoom in by reducing size then adjusting page scale (unable to zoom out using this method)
        await page.setViewport({
            width: Math.round(width / (zoom / 100)),
            height: Math.round(height / (zoom / 100))
        });

        await session.send('Emulation.setPageScaleFactor', {
            pageScaleFactor: (zoom / 100)
        });

        await session.send('Emulation.setVisibleSize', {
            width: width,
            height: height
        });
    } else {
        // Unset other zooming method
        await session.send('Emulation.resetPageScaleFactor');

        // Zoom out by emulating a scaled device (makes text blurry when zooming in with this method)
        await session.send('Emulation.setDeviceMetricsOverride', {
            width: Math.round(width / (zoom / 100)),
            height: Math.round(height / (zoom / 100)),
            mobile: false,
            deviceScaleFactor: 1,
            dontSetVisibleSize: true,
            viewport: {
                x: 0,
                y: 0,
                width: width,
                height: height,
                scale: (zoom / 100)
            }
        });
    }

    await this.frame.waitForSelector('html');
    this.frame.evaluate(function () {
        window.dispatchEvent(new Event('resize'));
    });
}

有更好的方法吗?

1 个答案:

答案 0 :(得分:0)

--force-device-scale-factor 命令行选项似乎适用于缩放完整的 chrome 用户界面,包括放大和缩小。

使用 puppeteer 将其传递给 chrome:

puppeteer.launch({
    args: ["--force-device-scale-factor=0.5"],
    headless: false,
})

(用铬 78 / puppeteer 1.20.0 测试)


但是如果您需要在不重启 chrome 的情况下进行缩放或者不想缩放整个 UI,实际上有一种方法可以使用 puppeteer 触发原生 chrome 缩放。

我创建了一个存储库来演示 here。 它的工作原理是绕过 chrome 扩展,它可以访问 chrome.tabs.setZoom API。

chrome-extension/manifest.json

{
    "name": "my-extension-name",
    "description": "A minimal chrome extension to help puppeteer with zooming",
    "version": "1.0",
    "manifest_version": 2,
    "background": {
        "scripts": ["background.js"],
        "persistent": false
    },
    "permissions": []
}

chrome-extension/background.js

function setZoom(tabId, zoomFactor) {
    chrome.tabs.setZoom(tabId, zoomFactor)
}

main.js

const puppeteer = require('puppeteer');

(async () => {
    const extensionPath = require('path').join(__dirname, 'chrome-extension');
    const extensionName = 'my-extension-name';

    const browser = await puppeteer.launch({
        args: [
            `--disable-extensions-except=${extensionPath}`,
            `--load-extension=${extensionPath}`
        ],
        headless: false,
    });
    const page = await browser.newPage();
    await page.goto('https://google.com');
    
    // get the background page of the extension
    const targets = await browser.targets();
    const extenstionPageTarget = targets.find(
        (target) => target._targetInfo.title === extensionName
    );
    const extensionPage = await extenstionPageTarget.page();

    // do the zooming by invoking setZoom of background.js
    const zoomFactor = 0.5
    await extensionPage.evaluate((zoomFactor) => {
        // a tabId of undefined defaults to the currently active tab
        const tabId = undefined;
        setZoom(tabId, zoomFactor);
    }, zoomFactor);
})();

我还没有找到使用 puppeteer 获取页面 tabId 的方法,尽管这可能通过扩展再次成为可能。 但是,如果您要缩放的页面是当前活动的页面,则上述操作即可。

请注意 loading chrome extensions does not currently work in headless mode,但幸运的是,这对您来说不是问题。