Firefox headless模式全页截图咨询：无需设置999999px高度

嘿，这个问题我刚好折腾过！Firefox 57+的无头模式默认确实只截取视口范围内的内容，但完全不用靠设置999999px这种笨办法，给你分享几个靠谱的解决方案：

1. 命令行直接生成整页截图（最简单） #

Firefox其实自带了整页截图的能力，用命令行就能直接搞定，根本不用手动调窗口高度。只需要带上--headless和--screenshot参数，指定目标URL即可：

firefox --headless --screenshot fullpage.png https://your-target-url.com

运行这个命令后，浏览器会自动识别页面的完整滚动高度，直接生成包含所有内容的截图，省心又高效。

2. GeckoDriver + Selenium动态适配高度（适合自动化场景） #

如果是写代码做自动化截图，别硬写超大高度，而是动态获取页面的实际高度再调整窗口。比如用Python的Selenium示例：

from selenium import webdriver
from selenium.webdriver.firefox.options import Options

# 配置无头模式
options = Options()
options.add_argument("--headless")

driver = webdriver.Firefox(options=options)
driver.get("https://your-target-url.com")

# 获取页面真实滚动高度
total_page_height = driver.execute_script("return document.body.scrollHeight")
# 设置窗口高度为页面实际高度（宽度可以按需调整）
driver.set_window_size(1920, total_page_height)

# 保存截图
driver.save_screenshot("fullpage_selenium.png")

driver.quit()

这种方式会根据页面实际内容调整高度，比硬设超大值更精准，不会出现截空或者漏截的情况。

3. DevTools协议直接指令（进阶玩法） #

Firefox支持Chrome DevTools协议（CDP），可以通过协议指令直接要求浏览器生成整页截图，连窗口大小都不用调。比如Node.js的示例：

const firefox = require('selenium-webdriver/firefox');
const { Builder } = require('selenium-webdriver');
const fs = require('fs');

async function captureFullPage() {
  const driver = await new Builder()
    .forBrowser('firefox')
    .setFirefoxOptions(new firefox.Options().headless())
    .build();

  try {
    await driver.get('https://your-target-url.com');
    // 创建CDP连接
    const cdpConnection = await driver.createCDPConnection('page');
    // 发送截图指令，开启captureBeyondViewport
    const screenshotData = await cdpConnection.send('Page.captureScreenshot', {
      captureBeyondViewport: true,
      format: 'png'
    });
    // 把base64数据转成文件保存
    fs.writeFileSync('fullpage_cdp.png', Buffer.from(screenshotData.data, 'base64'));
  } finally {
    await driver.quit();
  }
}

captureFullPage();

这种方法更灵活，适合需要精细控制截图参数的场景，而且不需要修改页面或窗口的任何属性。

内容的提问来源于stack exchange，提问作者Mr.Tr33