セッション再生
セッション再生は、実行された操作とネットワークリクエストを確認するための方法を提供します。この機能は、記録されたセッションを再生することで、実行された操作とネットワークリクエストをページごとに詳細に確認できます。
利点
✅ リアルタイム記録 – スクリプト実行中にすべてのネットワークリクエストを自動的に記録
✅ フレーム単位再生 – ブラウザ操作を正確に追跡
✅ チーム連携 – セッション記録を簡単に共有してチームでのデバッグが可能
✅ ミリ秒単位の精度 – イベントレベルのタイムスタンプを確認してスクリプト調整を強化
✅ セキュリティ保護 – セッションデータは暗号化され、きめ細かいアクセス制御によって保護されます
✅ 軽量フォーマット – rrweb駆動のDOM差分比較により、録画ファイルはビデオファイルより90%小さくなります
使い方
Scrapelessブラウザセッションの作成
タイプ1:Playgroundで新規セッション録画を作成
playgroundはデフォルトでパラメータ設定によりセッション録画が有効になっています。
Playgroundの設定でセッション録画を有効にすることもできます。ただし、Use Playground Settings オプションを有効にすると、playgroundコードの接続パラメータが上書きされることに注意してください。
設定後、「Run」をクリックして録画を開始します
タイプ2:APIで新規セッション録画を作成
他のプロジェクトでもAPIを使用してセッション機能に接続し、コード内のパラメータを設定することでセッションを設定できます。
録画機能を有効にするには、クエリパラメータsession_recording
をtrue
に設定する必要があります。このパラメータのデフォルト値はfalse
です。session_name
パラメータを使用してセッションに名前を付けると、セッションリストでセッションをすばやく見つけることができます。
詳細なドキュメントについては、Scraping Browser API Docsを参照してください。コード例を以下に示します。
const puppeteer =require('puppeteer-core');
const token = 'API Key'
// custom fingerprint
const fingerprint = {
platform: 'Windows',
}
const query = new URLSearchParams({
session_ttl: 180,
session_name: 'test_scraping', // session name
session_recording: true, // enable web session recording
proxy_country: 'ANY',
token: token,
fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});
const connectionURL = `wss://browser.scrapeless.com/browser?${query.toString()}`;
(async () => {
const browser = await puppeteer.connect({browserWSEndpoint: connectionURL});
const page = await browser.newPage();
await page.goto('https://www.scrapeless.com');
await new Promise(res => setTimeout(res, 3000));
await page.goto('https://www.google.com');
await new Promise(res => setTimeout(res, 3000));
await page.goto('https://www.youtube.com');
await new Promise(res => setTimeout(res, 3000));
await browser.close();
})();
再生の確認
ブラウザの実行が完了すると、セッション録画が自動的に記録されます。セッション履歴リストをクリックして確認できます。
制限
💡 セッション録画は、ブラウザでのユーザーの視覚的なエクスペリエンスのみに焦点を当てており、ページ構造(DOM)に反映されていない基盤となるサーバーアクティビティ、データベースのやり取り、または技術的な変更は含まれません。
💡 WebGLやcanvasなどの技術で構築された複雑なアニメーションは、セッション録画で完全に忠実に再現できない場合があります。