Question 1

CDP 経由で接続する際に、ウィンドウサイズが screen-width と screen-height に一致しない問題を修正する方法は？

Accepted Answer

screen-width および screen-height パラメータは、報告される画面サイズを設定しますが、ブラウザウィンドウのサイズは変更しません。CloakBrowser/Chrome を起動するときに、起動フラグ --window-size=1920,1080 を追加します（対象の幅と高さを使用してください）。これにより、外側のウィンドウとビューポートが、デフォルトの幅 780px のウィンドウではなく、指定した寸法を使用するようになります。

Question 2

クラッシュ後に CloakBrowser を起動するたびに発生する 'Target page, context or browser has been closed' エラーを修正する方法

Accepted Answer

これは、ブラウザプロセスが正常にシャットダウンされずに強制終了された場合（タスクマネージャー、`kill`、ターミナルのクローズ）に発生します。無料ティアのシートは15分のタイムアウト後に自動解放されるまで占有されたままとなり、その間に起動されたものはすべて最初の `page.goto()` で通知なく終了します。

修正方法:
1. ラッパーを v0.5.4 以降（最新は v0.5.8）にアップグレードしてください。これにより、上限超過時の起動で素の `TargetClosedError` の代わりに明確な `CloakBrowserLicenseError` が送出されるようになります: `pip install -U cloakbrowser`
2. 放棄されたシートが自動的に解放されるまで最大15分間待ってから、再度起動してください。
3. シートが即座に解放されるよう常に正常にクローズすることで再発を防ぎます。起動処理を `try/finally` または `with` ブロックで囲んでください:
```python
from cloakbrowser import launch

browser = launch(headless=False)
try:
    page = browser.new_page()
    # ... your work ...
finally:
    browser.close()
```
`try/finally` を使えば、例外や `Ctrl+C` が発生した場合でもシートは即座に解放されます。

Question 3

なぜ CloakBrowser で disable_non_proxied_udp を設定しているにもかかわらず、--fingerprint-webrtc-ip は直接の STUN UDP トラフィック経由で実際の IP をリークしてしまうのですか？

Accepted Answer

これは CloakBrowser Pro 151.0.7922.108.4 で確認されたバグです：`--fingerprint-webrtc-ip` は JavaScript から見える ICE candidate を書き換えますが、ブラウザは依然としてホストから直接 STUN UDP パケットを送信し、プロキシを迂回します — `--force-webrtc-ip-handling-policy=disable_non_proxied_udp` と `--webrtc-ip-handling-policy=disable_non_proxied_udp` を設定していても同様です。**修正方法：** 代わりに `--fingerprint-transparent-proxy` を指定して起動してください。これにより接続がプロキシ経由でトンネルされ、プロキシを経由しない UDP が完全に無効化されます（検証済み：外部インターフェース上の STUN パケットはゼロ、HTTPS は引き続きプロキシ経由）。このフラグは preview チャネルで利用可能で、次の stable リリースに搭載されます：
```js
{ releaseChannel: 'preview', args: ['--fingerprint-transparent-proxy', ...] }
```
それまでは、`--fingerprint-webrtc-ip` を省略すれば UDP 制限は有効に保たれますが、実際の IP が WebRTC から見える状態のままになります — そのため、transparent-proxy フラグが推奨される回避策です。

Question 4

CloakBrowser/Playwright で navigator.userAgentData がカスタム User-Agent と一致しないのをどう修正すればよいですか？

Accepted Answer

これは userAgent だけを上書きしても修正できません。Playwright の CDP エミュレーションは navigator.userAgent とレガシー HTTP UA ヘッダーのみを変更します。navigator.userAgentData、sec-ch-ua、GREASE ブランドデータは、実際の Chromium バイナリバージョンから生成されます。たとえば、Chromium 145 バイナリ上で Chrome/138 の UA 文字列を使っても、userAgentData では依然として Chrome/145 が報告されます。

シグナルを一貫させるには:

1. 異なる Chrome バージョンのカスタム UA を設定しないでください。
2. GitHub Releases から、必要なバージョンに一致するパッチ済み CloakBrowser ビルドをダウンロードしてください。現在利用可能なビルドには Chromium 142、145、146 が含まれます。
3. そのバイナリを executablePath で直接起動してください。各バージョンは ~/.cloakbrowser/chromium-{version}/ の下に個別にキャッシュされます。

例:
const browser = await chromium.launch({
  executablePath: "/Users/your-user/.cloakbrowser/chromium-145/CloakBrowser"
});

重み付きバージョン配分では、複数の実バイナリを並行して実行し、各セッションに一致する executablePath を選択してください。Chrome 138 や 140 などの任意の古いバージョンは提供されません。パッチはすべてのリリースにバックポートされるわけではないからです。

Question 5

なぜ CloakBrowser の fill() は数字を入力する際に桁を落とすのですか（例：1999 が 999 になる）？

Accepted Answer

これは cloakbrowser@0.4.13 の humanize タイプミス機能におけるバグです。シミュレートされたタイプミスが数字に対して発生すると、代わりに隣接する文字キーが押されてしまう場合があります。数値入力フィールドは文字を拒否するため、修正のための Backspace が直前に入力された数字を削除し、1999 が 999 になったり、2000 が 000 になったりします。このバグは修正済みで、次のラッパーリリースに含まれます。それまでは、コマンドごとに humanize 設定を上書きして、該当する呼び出しでタイプミスを無効にしてください:

```js
await page.fill('#num', '1999', { human_config: { mistype_chance: 0 } });
```

この方法で、任意の humanize 設定を呼び出しごとに上書きできます。この設定はその単一のコマンドにのみ影響します。

CloakBrowser

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト