参数：
    browser (Union[ListOrString, Iterable[Browser]], 可选)：浏览器或浏览器对象。
    os (ListOrString, 可选)：要为其生成头部的操作系统。
    device (ListOrString, 可选)：要为其生成头部的设备。
    locale (ListOrString, 可选)：Accept-Language头部的最多10种语言列表。默认为'en-US'。
    http_version (Literal[1, 2], 可选)：用于生成头部的HTTP版本。默认为2。
    strict (bool, 可选)：如果无法根据输入生成头部，则抛出错误。默认为False。

使用默认选项及其可能的覆盖生成头部。

参数：
    browser (Optional[Iterable[Union[str, Browser]]], 可选)：要为其生成头部的浏览器。
    os (Optional[ListOrString], 可选)：要为其生成头部的操作系统。
    device (Optional[ListOrString], 可选)：要为其生成头部的设备。
    locale (Optional[ListOrString], 可选)：要包含在Accept-Language头部中的语言。
    http_version (Optional[Literal[1, 2]], 可选)：用于生成头部的HTTP版本。
    user_agent (Optional[ListOrString], 可选)：要使用的User-Agent。
    request_dependent_headers (Optional[Dict[str, str]], 可选)：请求相关头部的已知值。
    strict (Optional[bool], 可选)：如果为true，则在无法根据输入生成头部时抛出错误。

参数:
    screen (Screen, 可选): 生成指纹的屏幕约束。
    strict (bool, 可选): 约束过于严格时是否抛出异常。默认为False。
    mock_webrtc (bool, 可选): 注入指纹时是否模拟WebRTC。默认为False。
    slim (bool, 可选): 注入指纹时禁用性能密集型规避。默认为False。
    **header_kwargs: HeaderGenerator的头部生成选项

生成指纹和匹配的有序头部集，使用构造函数中指定的默认选项和此处提供的可能覆盖的组合。

参数:
    screen (Screen, 可选): 生成指纹的屏幕约束。
    strict (bool, 可选): 约束过于严格时是否抛出异常。
    mock_webrtc (bool, 可选): 注入指纹时是否模拟WebRTC。默认为False。
    slim (bool, 可选): 注入指纹时禁用性能密集型规避。默认为False。
    **header_kwargs: HeaderGenerator.generate的附加头部生成选项。

屏幕宽度/高度

约束最小/最大屏幕宽度和高度：

from browserforge.fingerprints import Screen

screen = Screen(
    min_width=100
    max_width=1280
    min_height=400
    max_height=720
)

fingerprints = FingerprintGenerator(screen=screen)

注意：并非所有边界都需要定义。

浏览器规格

FingerprintGenerator 和 FingerprintGenerator.generate 继承了与 HeaderGenerator 相同的参数。

因此，用户代理、浏览器规格、设备类型和操作系统约束也可以传递给 FingerprintGenerator.generate。

以下是一个使用示例：

fingerprint.generate(browser='chrome', os='windows')

注入指纹

BrowserForge 与您现有的 Playwright 和 Pyppeteer 代码完全兼容。您只需更改上下文/页面初始化。

Playwright

异步 API：

# 导入 AsyncNewContext 注入器
from browserforge.injectors.playwright import AsyncNewContext

async def main():
    async with async_playwright() as playwright:
        browser = await playwright.chromium.launch()
        # 创建一个带有注入指纹的新异步上下文
        context = await AsyncNewContext(browser, fingerprint=fingerprint)
        page = await context.new_page()
        ...

在您现有的 Playwright 代码中，将 await browser.new_context 替换为 await AsyncNewContext。

使用指纹注入异步 API Playwright 上下文。

参数：
    browser (Browser)：用于创建上下文的浏览器
    fingerprint (Optional[Fingerprint])：要注入的指纹。如果为 None，将生成一个
    fingerprint_options (Optional[Dict])：如果未传递 `fingerprint`，则为指纹生成器的选项
    **new_context_options：新上下文的其他选项

同步 API：

# 导入 NewContext 注入器
from browserforge.injectors.playwright import NewContext

def main():
    with sync_playwright() as playwright:
        browser = playwright.chromium.launch()
        # 创建一个带有注入指纹的新上下文
        context = NewContext(browser, fingerprint=fingerprint)
        page = context.new_page()
        ...

在您现有的 Playwright 代码中，将 browser.new_context 替换为 NewContext。

使用指纹注入同步 API Playwright 上下文。

参数：
    browser (Browser)：用于创建上下文的浏览器
    fingerprint (Optional[Fingerprint])：要注入的指纹。如果为 None，将生成一个
    fingerprint_options (Optional[Dict])：如果未传递 `fingerprint`，则为指纹生成器的选项
    **new_context_options：新上下文的其他选项

Undetected-Playwright

Undetected-Playwright 也在 browserforge.injectors.undetected_playwright 包中得到支持。使用方法与 Playwright 注入器相同。

Pyppeteer

# 导入 NewPage 注入器
from browserforge.injectors.pyppeteer import NewPage
from pyppeteer import launch

async def test():
    browser = await launch()
    # 创建一个带有注入指纹的新页面
    page = await NewPage(browser, fingerprint=fingerprint)
    ...

在您现有的 Pyppeteer 代码中，将 browser.newPage 替换为 NewPage。

使用指纹注入 Pyppeteer 浏览器对象。

参数：
    browser (Browser)：用于创建上下文的浏览器
    fingerprint (Optional[Fingerprint])：要注入的指纹。如果为 None，将生成一个
    fingerprint_options (Optional[Dict])：如果未传递 `fingerprint`，则为指纹生成器的选项

卸载

要完全移除所有文件，请运行以下命令：

python -m browserforge remove
pip uninstall browserforge