BrowserStack Cloud Testing skill
クラウドベースの自動化、Percyによるビジュアル回帰テスト、およびオブザーバビリティツールを使用して、クロスブラウザおよびクロスデバイスのテストを実行します。
- GitHubスター
- 248
- ファイル
- 1
- 最終コミット
- 2026年11月3日
- ライセンス
- MIT
- 許可されたツール
- —
BrowserStack Cloud Testing skillは何をしますか
BrowserStack Cloud TestingはAgent Skillsです。 クラウドベースの自動化、Percyによるビジュアル回帰テスト、およびオブザーバビリティツールを使用して、クロスブラウザおよびクロスデバイスのテストを実行します。.
skillのSKILL.mdから生成された要約。
BrowserStack Cloud Testing skill について
多様な環境でWebおよびモバイルアプリケーションを検証する必要がある開発者は、このSKILLを使用してクラウドベースのテストを管理できます。AutomateやApp Automateなどのツールを使用して、さまざまなブラウザや実機上で自動テストを実行できます。Playwright、Selenium、Cypress、Appiumなどのフレームワークと統合することで、包括的なエンドツーエンド、モバイル、およびパフォーマンスのテストが可能です。
Percyを通じてビジュアル回帰テストを実装し、異なるビューポート間でのUIの不一致を検出できます。また、BrowserStack Localのセキュアなトンネルを介して、ステージング環境やlocalhostで動作しているアプリケーションのテストもサポートしています。デバッグに関しては、AIを活用した失敗分析や不安定なテストの検出を行うオブザーバビリティ機能を提供します。GitHub ActionsなどのCI/CDパイプライン内で動作するように設計されており、テストワークフローの自動化や並列セッションによる実行の最適化を実現します。
エージェントができること
- 1クロスブラウザのPlaywrightテストの設定異なるオペレーティングシステム上のChrome、Firefox、Safariでテストを実行するためのPlaywright設定をセットアップします。
- 2ビジュアル回帰テストの実装既存の自動化スイートにPercyのスナップショットを統合し、自動的なビジュアル比較を実行します。
- 3ローカルのステージング環境のテスト本番環境にデプロイする前に、localhostで動作しているアプリケーションをテストするためのセキュアなトンネルを確立します。
- 4AIによるテスト失敗の分析オブザーバビリティツールを使用して、不安定なテストを検出し、テスト失敗のAIによる分析を行います。
skill の SKILL.md から作成されています。すべてのユースケースは、その引用と照合されています。
BrowserStack Cloud Testing skillのインストール方法
各コマンドはskillフォルダをクライアントのskillsディレクトリにコピーします。読み込むには、クライアントを再起動するか新しいセッションを開始してください。Claude CodeにBrowserStack Cloud Testing skillをインストールする
~/.claude/skills/BrowserStack-Cloud-Testing/SKILL.md
$ npx degit PramodDutta/qaskills/seed-skills/browserstack-testing ~/.claude/skills/BrowserStack-Cloud-TestingClaude Code (project)にBrowserStack Cloud Testing skillをインストールする
.claude/skills/BrowserStack-Cloud-Testing/SKILL.md
$ npx degit PramodDutta/qaskills/seed-skills/browserstack-testing .claude/skills/BrowserStack-Cloud-TestingCodexにBrowserStack Cloud Testing skillをインストールする
~/.agents/skills/BrowserStack-Cloud-Testing/SKILL.md
$ npx degit PramodDutta/qaskills/seed-skills/browserstack-testing ~/.agents/skills/BrowserStack-Cloud-TestingGemini CLIにBrowserStack Cloud Testing skillをインストールする
~/.gemini/skills/BrowserStack-Cloud-Testing/SKILL.md
$ npx degit PramodDutta/qaskills/seed-skills/browserstack-testing ~/.gemini/skills/BrowserStack-Cloud-TestingClaude.aiにBrowserStack Cloud Testing skillをインストールする
npx degit PramodDutta/qaskills/seed-skills/browserstack-testing BrowserStack-Cloud-Testing && zip -r BrowserStack-Cloud-Testing.zip BrowserStack-Cloud-Testing # claude.ai → Customize → Skills → + → Create skill → Upload a skill → BrowserStack-Cloud-Testing.zip
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。スキルにはスコア 80、重大な指摘なし、チェックに十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能pramoddutta/qaskills/seed-skills/browserstack-testing is public and reachablegithub.com/pramoddutta/qaskills/tree/HEAD/seed-skills/browse ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit 2026-11-03github.com/pramoddutta/qaskills/commits ↗合格
- スクリプトにダウンロード実行や認証情報の窃取がないNo scripts in the skill folder合格
- SKILL.md に隠れた指示がないNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/pramoddutta/qaskills/blob/HEAD/seed-skills/browse ↗合格
- 事前許可ツールが限定されているNo pre-approved tools; the agent asks before using onegithub.com/pramoddutta/qaskills/blob/HEAD/seed-skills/browse ↗合格
- SKILL.md が Agent Skills の形式に従っているname "BrowserStack Cloud Testing" is not 1-64 lowercase letters, digits and single hyphensgithub.com/pramoddutta/qaskills/blob/HEAD/seed-skills/browse ↗検出事項
SKILL.md
GitHubで表示BrowserStack Cloud Testing Skill
You are an expert in BrowserStack cloud testing platform. When the user asks you to set up cross-browser testing, configure BrowserStack Automate with Playwright or Selenium, implement Percy visual testing, or optimize cloud test execution, follow these detailed instructions.
Core Principles
- Capability-driven browser selection -- Define browser and device capabilities precisely. Use BrowserStack's capability generators to avoid configuration errors.
- Parallel execution optimization -- Maximize parallel test sessions to reduce total execution time. Design tests for independence to enable safe parallelization.
- Local testing for pre-deployment -- Use BrowserStack Local to test staging environments and localhost applications through a secure tunnel before deploying to production.
- Visual regression with Percy -- Integrate Percy snapshots into existing Playwright or Selenium tests for automated visual comparison across browsers and viewports.
- Observability for debugging -- Enable BrowserStack Observability to get AI-powered failure analysis, flaky test detection, and performance insights without additional instrumentation.
- Network and geolocation simulation -- Use BrowserStack's network throttling and geolocation capabilities to test under realistic conditions for global users.
- Cost-efficient test distribution -- Balance test coverage across browsers and devices based on analytics data. Test the top 80% of user configurations, not every possible combination.
Project Structure
browserstack-tests/
config/
browserstack.config.ts
capabilities.ts
local-config.ts
tests/
e2e/
login.spec.ts
checkout.spec.ts
search.spec.ts
visual/
homepage-visual.spec.ts
product-page-visual.spec.ts
mobile/
mobile-navigation.spec.ts
mobile-checkout.spec.ts
helpers/
browserstack-client.ts
local-tunnel.ts
capability-builder.ts
percy/
percy-config.ts
snapshot-helpers.ts
scripts/
run-parallel.sh
check-session-status.ts
reports/
.gitkeep
Playwright + BrowserStack Configuration
// config/browserstack.config.ts
import { defineConfig, devices } from '@playwright/test';
const BS_CAPS = {
'browserstack.username': process.env.BROWSERSTACK_USERNAME || '',
'browserstack.accessKey': process.env.BROWSERSTACK_ACCESS_KEY || '',
'browserstack.local': process.env.BROWSERSTACK_LOCAL || 'false',
'browserstack.playwrightVersion': '1.latest',
'browserstack.debug': 'true',
'browserstack.networkLogs': 'true',
'browserstack.consoleLogs': 'info',
};
export default defineConfig({
testDir: './tests',
fullyParallel: true,
retries: 1,
workers: 5,
reporter: [
['html', { open: 'never' }],
['json', { outputFile: 'reports/results.json' }],
],
use: {
baseURL: process.env.BASE_URL || 'http://localhost:3000',
trace: 'on-first-retry',
screenshot: 'only-on-failure',
},
projects: [
{
name: 'chrome-latest-windows',
use: {
connectOptions: {
wsEndpoint: buildWSEndpoint({
...BS_CAPS,
browser: 'chrome',
browser_version: 'latest',
os: 'Windows',
os_version: '11',
name: 'Chrome Latest Windows',
build: getBuildName(),
}),
},
},
},
{
name: 'firefox-latest-windows',
use: {
connectOptions: {
wsEndpoint: buildWSEndpoint({
...BS_CAPS,
browser: 'playwright-firefox',
browser_version: 'latest',
os: 'Windows',
os_version: '11',
name: 'Firefox Latest Windows',
build: getBuildName(),
}),
},
},
},
{
name: 'safari-latest-macos',
use: {
connectOptions: {
wsEndpoint: buildWSEndpoint({
...BS_CAPS,
browser: 'playwright-webkit',
browser_version: 'latest',
os: 'OS X',
os_version: 'Sonoma',
name: 'Safari Latest macOS',
build: getBuildName(),
}),
},
},
},
{
name: 'iphone-15',
use: {
connectOptions: {
wsEndpoint: buildWSEndpoint({
...BS_CAPS,
browser: 'playwright-webkit',
device: 'iPhone 15',
os_version: '17',
name: 'iPhone 15',
build: getBuildName(),
}),
},
},
},
{
name: 'pixel-8',
use: {
connectOptions: {
wsEndpoint: buildWSEndpoint({
...BS_CAPS,
browser: 'chrome',
device: 'Google Pixel 8',
os_version: '14.0',
name: 'Pixel 8',
build: getBuildName(),
}),
},
},
},
],
});
function buildWSEndpoint(caps: Record<string, string>): string {
const encoded = encodeURIComponent(JSON.stringify(caps));
return `wss://cdp.browserstack.com/playwright?caps=${encoded}`;
}
function getBuildName(): string {
const timestamp = new Date().toISOString().split('T')[0];
const ci = process.env.CI ? 'CI' : 'local';
const commit = process.env.GITHUB_SHA?.substring(0, 7) || 'dev';
return `${ci}-${timestamp}-${commit}`;
}
BrowserStack Local Tunnel
// helpers/local-tunnel.ts
import * as BrowserStackLocal from 'browserstack-local';
export class LocalTunnel {
private bsLocal: any;
constructor() {
this.bsLocal = new BrowserStackLocal.Local();
}
async start(options?: {
key?: string;
localIdentifier?: string;
verbose?: boolean;
force?: boolean;
forceLocal?: boolean;
}): Promise<void> {
return new Promise((resolve, reject) => {
const config = {
key: options?.key || process.env.BROWSERSTACK_ACCESS_KEY,
localIdentifier: options?.localIdentifier || `local-${Date.now()}`,
verbose: options?.verbose ? '1' : '0',
force: options?.force ? 'true' : 'false',
forceLocal: options?.forceLocal ? 'true' : 'false',
};
this.bsLocal.start(config, (error: any) => {
if (error) {
reject(new Error(`BrowserStack Local failed to start: ${error.message}`));
} else {
console.log('BrowserStack Local tunnel started');
resolve();
}
});
});
}
async stop(): Promise<void> {
return new Promise((resolve) => {
if (this.bsLocal.isRunning()) {
this.bsLocal.stop(() => {
console.log('BrowserStack Local tunnel stopped');
resolve();
});
} else {
resolve();
}
});
}
isRunning(): boolean {
return this.bsLocal.isRunning();
}
}
Percy Visual Testing Integration
// tests/visual/homepage-visual.spec.ts
import { test, expect } from '@playwright/test';
test.describe('Homepage Visual Regression', () => {
test('homepage renders correctly on desktop', async ({ page }) => {
await page.goto('/');
await page.waitForLoadState('networkidle');
// Take Percy snapshot
await page.evaluate(() => {
// Percy snapshot via CLI or SDK
(window as any).__percy_snapshot_name = 'Homepage - Desktop';
});
// Fallback assertions
await expect(page.getByRole('heading', { level: 1 })).toBeVisible();
await expect(page.getByRole('navigation')).toBeVisible();
});
test('homepage renders correctly on mobile', async ({ page }) => {
await page.setViewportSize({ width: 375, height: 812 });
await page.goto('/');
await page.waitForLoadState('networkidle');
await expect(page.getByRole('heading', { level: 1 })).toBeVisible();
// Mobile hamburger menu should be visible
await expect(page.getByRole('button', { name: /menu/i })).toBeVisible();
});
});
BrowserStack Session Management
// helpers/browserstack-client.ts
interface SessionInfo {
name: string;
duration: number;
os: string;
os_version: string;
browser: string;
browser_version: string;
status: 'passed' | 'failed' | 'error';
reason: string;
public_url: string;
video_url: string;
logs: string;
}
export class BrowserStackClient {
private username: string;
private accessKey: string;
private baseUrl = 'https://api.browserstack.com';
constructor() {
this.username = process.env.BROWSERSTACK_USERNAME || '';
this.accessKey = process.env.BROWSERSTACK_ACCESS_KEY || '';
}
private get authHeader(): string {
return `Basic ${Buffer.from(`${this.username}:${this.accessKey}`).toString('base64')}`;
}
async updateSessionStatus(
sessionId: string,
status: 'passed' | 'failed',
reason?: string
): Promise<void> {
await fetch(`${this.baseUrl}/automate/sessions/${sessionId}.json`, {
method: 'PUT',
headers: {
'Content-Type': 'application/json',
Authorization: this.authHeader,
},
body: JSON.stringify({ status, reason }),
});
}
async getSession(sessionId: string): Promise<SessionInfo> {
const response = await fetch(
`${this.baseUrl}/automate/sessions/${sessionId}.json`,
{ headers: { Authorization: this.authHeader } }
);
const data = await response.json();
return data.automation_session;
}
async getBuilds(limit = 10): Promise<any[]> {
const response = await fetch(
`${this.baseUrl}/automate/builds.json?limit=${limit}`,
{ headers: { Authorization: this.authHeader } }
);
const data = await response.json();
return data;
}
async getBuildSessions(buildId: string): Promise<any[]> {
const response = await fetch(
`${this.baseUrl}/automate/builds/${buildId}/sessions.json`,
{ headers: { Authorization: this.authHeader } }
);
return response.json();
}
async getAccountUsage(): Promise<{ parallel_sessions_running: number; parallel_sessions_max: number }> {
const response = await fetch(`${this.baseUrl}/automate/plan.json`, {
headers: { Authorization: this.authHeader },
});
return response.json();
}
}
GitHub Actions Integration
# .github/workflows/browserstack-tests.yml
name: BrowserStack Cross-Browser Tests
on:
push:
branches: [main]
pull_request:
jobs:
browserstack:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: 20
- name: Install dependencies
run: npm ci
- name: Start BrowserStack Local
uses: browserstack/github-actions/setup-local@master
with:
local-testing: start
local-identifier: github-${{ github.run_id }}
- name: Run Playwright tests on BrowserStack
env:
BROWSERSTACK_USERNAME: ${{ secrets.BROWSERSTACK_USERNAME }}
BROWSERSTACK_ACCESS_KEY: ${{ secrets.BROWSERSTACK_ACCESS_KEY }}
BROWSERSTACK_LOCAL: 'true'
BROWSERSTACK_LOCAL_IDENTIFIER: github-${{ github.run_id }}
run: npx playwright test --config=config/browserstack.config.ts
- name: Stop BrowserStack Local
if: always()
uses: browserstack/github-actions/setup-local@master
with:
local-testing: stop
- name: Upload Reports
if: always()
uses: actions/upload-artifact@v4
with:
name: browserstack-reports
path: reports/
Capability Builder Utility
// helpers/capability-builder.ts
interface BrowserCapability {
browser: string;
browserVersion: string;
os: string;
osVersion: string;
deviceName?: string;
buildName: string;
sessionName: string;
}
export class CapabilityBuilder {
private baseCapabilities: Record<string, string> = {};
constructor() {
this.baseCapabilities = {
'browserstack.username': process.env.BROWSERSTACK_USERNAME || '',
'browserstack.accessKey': process.env.BROWSERSTACK_ACCESS_KEY || '',
'browserstack.debug': 'true',
'browserstack.networkLogs': 'true',
'browserstack.consoleLogs': 'info',
};
}
desktop(browser: string, version: string, os: string, osVersion: string): Record<string, string> {
return {
...this.baseCapabilities,
browser,
browser_version: version,
os,
os_version: osVersion,
resolution: '1920x1080',
};
}
mobile(device: string, osVersion: string, browser = 'chrome'): Record<string, string> {
return {
...this.baseCapabilities,
device,
os_version: osVersion,
browser,
realMobile: 'true',
};
}
withLocal(identifier: string): this {
this.baseCapabilities['browserstack.local'] = 'true';
this.baseCapabilities['browserstack.localIdentifier'] = identifier;
return this;
}
withBuild(name: string): this {
this.baseCapabilities['build'] = name;
return this;
}
withGeolocation(country: string): this {
this.baseCapabilities['browserstack.geoLocation'] = country;
return this;
}
withNetworkProfile(profile: 'no-throttling' | '4g' | '3g' | '2g'): this {
const profiles: Record<string, string> = {
'no-throttling': 'no-throttling',
'4g': '4g-lte-advanced-good',
'3g': '3g-umts-good',
'2g': '2g-gprs-good',
};
this.baseCapabilities['browserstack.networkProfile'] = profiles[profile];
return this;
}
}
// Usage examples
const builder = new CapabilityBuilder()
.withBuild('PR-123-smoke')
.withLocal('github-12345');
const chromeWindows = builder.desktop('chrome', 'latest', 'Windows', '11');
const safariMac = builder.desktop('safari', 'latest', 'OS X', 'Sonoma');
const iPhone15 = builder.mobile('iPhone 15', '17');
const pixel8 = builder.mobile('Google Pixel 8', '14.0');
Cross-Browser Test Strategy
Not every test needs to run on every browser. Design a tiered execution strategy that maximizes coverage while minimizing cost and execution time.
Tier 1 runs on every commit and includes the smoke test suite on Chrome latest. This catches obvious regressions quickly.
Tier 2 runs on pull request merges and includes the full regression suite on Chrome, Firefox, and Safari. This catches cross-browser issues before code reaches the main branch.
Tier 3 runs nightly and includes the complete test suite on all configured browsers and devices, plus performance benchmarks. This catches subtle issues that only appear in specific browser or device configurations.
Tier 4 runs weekly and includes accessibility testing across all browsers, visual regression on key pages, and mobile-specific interaction testing on real devices.
Configure BrowserStack Observability to track test results across tiers. This provides a dashboard showing which browsers have the most failures, which tests are most likely to fail on specific browsers, and which device configurations need additional coverage.
Best Practices
- Use BrowserStack's capability generator -- Avoid guessing browser and OS combinations. Use the official capability generator to produce correct configurations.
- Set meaningful build and session names -- Include CI build number, branch name, and timestamp in build names for easy identification in the dashboard.
- Enable BrowserStack Local for pre-production testing -- Test against staging and localhost environments using the secure tunnel before deploying to production.
- Parallelize based on your plan -- Check your BrowserStack plan's parallel session limit and configure workers accordingly to maximize throughput.
- Use Percy for visual regression -- Integrate Percy snapshots into critical page tests. Configure responsive widths to catch layout issues across breakpoints.
- Enable network and console logs -- Always enable logging in capabilities for debugging. Logs are invaluable when tests fail on specific browsers.
- Mark session status after test completion -- Use the BrowserStack API to mark sessions as passed or failed so the dashboard accurately reflects test results.
- Test on real devices for mobile -- BrowserStack real device testing is more reliable than emulators for mobile-specific bugs.
- Monitor session usage -- Track parallel session utilization to identify opportunities to optimize test distribution.
- Cache BrowserStack Local binary -- In CI, cache the BrowserStack Local binary to avoid re-downloading it on every run.
Anti-Patterns
- Testing every browser combination -- Testing on 50+ browser/OS combinations is wasteful. Analyze user analytics to identify the top 5-10 configurations that cover 90% of users.
- Running all tests on all browsers -- Run the full suite on Chrome, smoke tests on Firefox and Safari, and critical paths on mobile devices.
- Not using BrowserStack Local for staging -- Skipping local testing means bugs are only found after deployment. Always test pre-production environments.
- Hardcoding credentials in config files -- Use environment variables for BrowserStack username and access key. Never commit credentials.
- Ignoring flaky test detection -- BrowserStack Observability identifies flaky tests. Ignoring these leads to unreliable CI pipelines.
- Not setting timeouts appropriately -- Cloud execution is slower than local. Set generous timeouts for element waits and page loads.
- Running sequential tests on cloud -- Sequential execution wastes parallel session capacity. Always run tests in parallel on BrowserStack.
- Skipping session cleanup -- Orphaned sessions consume your parallel quota. Always clean up sessions in afterAll hooks.
- Not reviewing video recordings -- BrowserStack provides video recordings of every session. Review failed test videos before debugging code.
- Using stale browser versions -- Browser capabilities change with updates. Regularly update your browser version targets to match current releases.
このスキルのファイル
1BrowserStack Cloud Testing skillに関する質問
Claude CodeにBrowserStack Cloud Testing skillをインストールするには
npx degit PramodDutta/qaskills/seed-skills/browserstack-testing ~/.claude/skills/BrowserStack-Cloud-Testingを実行してください。Claude Codeは~/.claude/skills(すべてのプロジェクト)または.claude/skills(単一プロジェクト)からskillsを読み込み、説明がタスクに一致する場合にskillを使用します。
BrowserStack Cloud Testing skillはどのクライアントで使用できますか
Agent Skills形式を読み込むすべてのクライアントで使用できます: Claude Code、Codex、Gemini CLI、claude.ai(ZIPとしてアップロード)。skill内のスクリプトは、クライアントがコード実行を許可した場合にのみ実行されます。
localhostやステージング環境で実行されているアプリケーションをテストするにはどうすればよいですか?
BrowserStack Localを使用すると、セキュアなトンネルを作成して、本番環境にデプロイされる前にローカルまたはステージング環境をテストできます。
BrowserStackでビジュアル回帰テストを実行できますか?
はい、PercyのスナップショットをPlaywrightやSeleniumのテストに統合することで、異なるブラウザやビューポート間で自動的なビジュアル比較を実行できます。
BrowserStackはテスト失敗時のデバッグにどのように役立ちますか?
BrowserStack Observabilityは、追加のインストルメンテーションを必要とせずに、AIを活用した失敗分析、不安定なテスト(flaky tests)の検出、およびパフォーマンスに関するインサイトを提供します。