testdriverai 7.2.9 → 7.2.11

package/docs/v7/features/powerful.mdx

@@ -1,531 +0,0 @@
----
-title: "Multi-Target Testing"
-description: "Test anything, anywhere - web, desktop, mobile, extensions"
-icon: "wand-magic-sparkles"
----
-
-TestDriver is the only testing platform that lets you test web applications, desktop apps, browser extensions, and IDE extensions with the same simple API.
-
-## Test Anything
-
-One SDK, unlimited testing possibilities:
-
-<CardGroup cols={2}>
-  <Card title="Web Applications" icon="globe">
-    Test any website or web application
-  </Card>
-
-  <Card title="Desktop Applications" icon="desktop">
-    Windows, macOS, and Linux native apps
-  </Card>
-
-  <Card title="Chrome Extensions" icon="puzzle-piece">
-    Browser extensions and add-ons
-  </Card>
-
-  <Card title="VS Code Extensions" icon="code">
-    IDE extensions and plugins
-  </Card>
-
-  <Card title="Electron Apps" icon="atom">
-    Cross-platform Electron applications
-  </Card>
-
-  <Card title="Mobile Apps" icon="mobile">
-    Android and iOS applications (beta)
-  </Card>
-</CardGroup>
-
-## Web Applications
-
-Test any website with the Chrome preset:
-
-```javascript
-import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
-
-test('web application test', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com',
-    maximized: true,
-    guest: true, // Incognito mode
-    os: 'linux'
-  });
-
-  await testdriver.find('Login button').click();
-  await testdriver.find('email input').type('user@example.com');
-  await testdriver.find('password input').type('secret', { secret: true });
-  await testdriver.find('Submit').click();
-
-  await testdriver.assert('Dashboard is visible');
-});
-```
-
-<Card title="Chrome Preset Documentation" icon="chrome" href="/v7/presets/chrome">
-  Complete guide to testing web applications
-</Card>
-
-## Desktop Applications
-
-Test native desktop applications on any platform:
-
-<Tabs>
-  <Tab title="Windows">
-    ```javascript
-    import { desktop } from 'testdriverai/presets';
-
-    test('windows app', async (context) => {
-      const { testdriver } = await desktop(context, {
-        appPath: 'C:\\Program Files\\MyApp\\MyApp.exe',
-        os: 'windows'
-      });
-
-      await testdriver.find('File menu').click();
-      await testdriver.find('New Document').click();
-      await testdriver.assert('New document window is open');
-    });
-    ```
-  </Tab>
-
-  <Tab title="macOS">
-    ```javascript
-    import { desktop } from 'testdriverai/presets';
-
-    test('macos app', async (context) => {
-      const { testdriver } = await desktop(context, {
-        appPath: '/Applications/MyApp.app',
-        os: 'mac'
-      });
-
-      await testdriver.pressKeys(['cmd', 'n']); // New window
-      await testdriver.assert('Untitled document is displayed');
-    });
-    ```
-  </Tab>
-
-  <Tab title="Linux">
-    ```javascript
-    import { desktop } from 'testdriverai/presets';
-
-    test('linux app', async (context) => {
-      const { testdriver } = await desktop(context, {
-        appPath: '/usr/bin/myapp',
-        os: 'linux'
-      });
-
-      await testdriver.find('Settings button').click();
-      await testdriver.find('Theme dropdown').click();
-      await testdriver.find('Dark mode option').click();
-    });
-    ```
-  </Tab>
-</Tabs>
-
-<CardGroup cols={3}>
-  <Card title="Windows" icon="windows" href="/v7/platforms/windows">
-    Windows testing guide
-  </Card>
-
-  <Card title="macOS" icon="apple" href="/v7/platforms/macos">
-    macOS testing guide
-  </Card>
-
-  <Card title="Linux" icon="linux" href="/v7/platforms/linux">
-    Linux testing guide
-  </Card>
-</CardGroup>
-
-## Chrome Extensions
-
-Test browser extensions in their natural environment:
-
-```javascript
-import { test } from 'vitest';
-import { chromeExtension } from 'testdriverai/presets';
-
-test('chrome extension', async (context) => {
-  const { testdriver } = await chromeExtension(context, {
-    extensionPath: './my-extension',
-    url: 'https://example.com'
-  });
-
-  // Test extension popup
-  await testdriver.find('extension icon in toolbar').click();
-  await testdriver.find('Settings button in popup').click();
-
-  // Test extension functionality
-  await testdriver.find('Enable feature checkbox').click();
-  await testdriver.assert('Feature is enabled message appears');
-
-  // Test on web page
-  await testdriver.find('extension-injected content on page').click();
-  await testdriver.assert('Extension content is visible');
-});
-```
-
-<Card title="Chrome Extension Guide" icon="puzzle-piece" href="/v7/presets/chrome-extension">
-  Complete extension testing documentation
-</Card>
-
-## VS Code Extensions
-
-Test IDE extensions with the VS Code preset:
-
-```javascript
-import { test } from 'vitest';
-import { vscode } from 'testdriverai/presets';
-
-test('vscode extension', async (context) => {
-  const { testdriver } = await vscode(context, {
-    workspace: '/tmp/test-project',
-    extensions: ['ms-python.python', 'dbaeumer.vscode-eslint']
-  });
-
-  // Open command palette
-  await testdriver.pressKeys(['cmd', 'shift', 'p']);
-  await testdriver.type('Python: Create New File');
-  await testdriver.pressKeys(['enter']);
-
-  // Verify extension behavior
-  await testdriver.assert('Untitled Python file is open');
-  await testdriver.assert('Python extension is active');
-
-  // Test extension commands
-  await testdriver.type('print("Hello World")');
-  await testdriver.pressKeys(['cmd', 's']); // Save
-  await testdriver.find('filename input').type('test.py');
-  await testdriver.pressKeys(['enter']);
-
-  await testdriver.assert('test.py is saved');
-});
-```
-
-<Card title="VS Code Preset Guide" icon="code" href="/v7/presets/vscode">
-  Complete VS Code extension testing
-</Card>
-
-## Electron Applications
-
-Test Electron apps with specialized support:
-
-```javascript
-import { test } from 'vitest';
-import { electron } from 'testdriverai/presets';
-
-test('electron app', async (context) => {
-  const { app } = await electron(context, {
-    appPath: './dist/my-electron-app',
-    args: ['--debug']
-  });
-
-  // Test native menu
-  await app.find('File menu').click();
-  await app.find('New Window').click();
-
-  // Test application UI
-  await app.find('sidebar toggle').click();
-  await app.assert('sidebar is collapsed');
-
-  // Test window interactions
-  await app.pressKeys(['cmd', 'w']); // Close window
-  await app.assert('window is closed');
-});
-```
-
-<Card title="Electron Preset Guide" icon="atom" href="/v7/presets/electron">
-  Complete Electron testing documentation
-</Card>
-
-## Cross-Platform Testing
-
-Run the same test across multiple platforms:
-
-```javascript
-import { test } from 'vitest';
-import { desktop } from 'testdriverai/presets';
-
-const platforms = ['linux', 'mac', 'windows'];
-
-platforms.forEach((os) => {
-  test(`app works on ${os}`, async (context) => {
-    const { testdriver } = await desktop(context, {
-      appPath: getAppPathForOS(os),
-      os
-    });
-
-    await testdriver.find('File menu').click();
-    await testdriver.find('New Document').click();
-    await testdriver.assert('New document is created');
-  });
-});
-
-function getAppPathForOS(os) {
-  switch (os) {
-    case 'windows': return 'C:\\Program Files\\MyApp\\MyApp.exe';
-    case 'mac': return '/Applications/MyApp.app';
-    case 'linux': return '/usr/bin/myapp';
-  }
-}
-```
-
-## Multiple Applications
-
-Test interactions between multiple applications:
-
-```javascript
-test('cross-app workflow', async (context) => {
-  // Start VS Code
-  const { testdriver: vscode } = await vscode(context, {
-    workspace: '/tmp/project'
-  });
-
-  await vscode.type('// TODO: Implement feature');
-  await vscode.pressKeys(['cmd', 's']);
-
-  // Switch to browser
-  const { testdriver: chrome } = await chrome(context, {
-    url: 'https://jira.company.com'
-  });
-
-  await chrome.find('Create issue button').click();
-  await chrome.find('Summary input').type('Implement feature');
-  await chrome.find('Submit').click();
-
-  // Switch back to VS Code
-  await vscode.focusApplication('VS Code');
-  await vscode.assert('TODO comment is visible');
-});
-```
-
-## Advanced Interactions
-
-TestDriver handles complex interaction patterns:
-
-<AccordionGroup>
-  <Accordion title="Drag and Drop">
-    ```javascript
-    const element = await testdriver.find('draggable item');
-    await element.mouseDown();
-
-    await testdriver.hover(500, 300); // Drag to position
-    await testdriver.mouseUp(); // Drop
-
-    await testdriver.assert('Item is in new position');
-    ```
-  </Accordion>
-
-  <Accordion title="Keyboard Shortcuts">
-    ```javascript
-    // Multi-key combinations
-    await testdriver.pressKeys(['ctrl', 'shift', 'p']);
-
-    // Platform-specific shortcuts
-    const modKey = os === 'mac' ? 'cmd' : 'ctrl';
-    await testdriver.pressKeys([modKey, 'c']); // Copy
-    await testdriver.pressKeys([modKey, 'v']); // Paste
-    ```
-  </Accordion>
-
-  <Accordion title="File Uploads">
-    ```javascript
-    await testdriver.find('file upload button').click();
-
-    // Type file path in dialog
-    await testdriver.type('/path/to/file.pdf');
-    await testdriver.pressKeys(['enter']);
-
-    await testdriver.assert('File is uploaded');
-    ```
-  </Accordion>
-
-  <Accordion title="Context Menus">
-    ```javascript
-    await testdriver.find('file item').rightClick();
-    await testdriver.find('Delete option in context menu').click();
-    await testdriver.assert('Confirmation dialog appears');
-    ```
-  </Accordion>
-</AccordionGroup>
-
-## Execute Custom Code
-
-Run JavaScript or PowerShell for advanced scenarios:
-
-<Tabs>
-  <Tab title="JavaScript (Browser)">
-    ```javascript
-    // Execute code in browser context
-    const title = await testdriver.exec('js', 'document.title', 5000);
-    console.log('Page title:', title);
-
-    // Modify DOM
-    await testdriver.exec('js', `
-      document.querySelector('#username').value = 'testuser';
-      document.querySelector('#submit').click();
-    `, 5000);
-
-    // Extract data
-    const items = await testdriver.exec('js', `
-      Array.from(document.querySelectorAll('.item'))
-        .map(el => el.textContent)
-    `, 5000);
-    ```
-  </Tab>
-
-  <Tab title="PowerShell (Windows)">
-    ```javascript
-    // Execute PowerShell commands
-    await testdriver.exec('pwsh',
-      'Start-Process notepad.exe',
-      5000
-    );
-
-    // Install dependencies
-    await testdriver.exec('pwsh',
-      'npm install -g http-server',
-      30000
-    );
-
-    // Start local server
-    await testdriver.exec('pwsh',
-      'http-server ./dist -p 8080',
-      5000
-    );
-    ```
-  </Tab>
-
-  <Tab title="Bash (Linux/Mac)">
-    ```javascript
-    // Execute bash commands
-    await testdriver.exec('bash',
-      'open /Applications/MyApp.app',
-      5000
-    );
-
-    // Setup test environment
-    await testdriver.exec('bash', `
-      cd /tmp/project &&
-      npm install &&
-      npm run build
-    `, 60000);
-    ```
-  </Tab>
-</Tabs>
-
-## Mobile Applications (Beta)
-
-TestDriver supports mobile app testing:
-
-```javascript
-import { android } from 'testdriverai/presets';
-
-test('android app', async (context) => {
-  const { testdriver } = await android(context, {
-    appPath: './app.apk',
-    device: 'Pixel 7'
-  });
-
-  await testdriver.find('Login button').click();
-  await testdriver.find('username field').type('user@example.com');
-  await testdriver.find('password field').type('secret', { secret: true });
-  await testdriver.find('Submit').click();
-
-  await testdriver.assert('Home screen is visible');
-});
-```
-
-<Note>
-  Mobile testing is in beta. Contact sales for early access.
-</Note>
-
-## Real-World Example
-
-Here's a complex cross-platform test:
-
-```javascript
-test('full application workflow', async (context) => {
-  // Test web application
-  const { testdriver: web } = await chrome(context, {
-    url: 'https://myapp.com'
-  });
-
-  await web.find('Export data button').click();
-  await web.find('Download as CSV').click();
-  await web.assert('Download started notification');
-
-  // Test desktop application
-  const { testdriver: desktop } = await desktop(context, {
-    appPath: '/Applications/MyApp.app',
-    os: 'mac'
-  });
-
-  await desktop.find('Import button').click();
-  await desktop.find('Select file button').click();
-  await desktop.type('~/Downloads/export.csv');
-  await desktop.pressKeys(['enter']);
-  await desktop.assert('Import successful message');
-
-  // Test VS Code extension
-  const { testdriver: vscode } = await vscode(context, {
-    workspace: '/tmp/project',
-    extensions: ['mycompany.myapp-extension']
-  });
-
-  await vscode.pressKeys(['cmd', 'shift', 'p']);
-  await vscode.type('MyApp: Sync Data');
-  await vscode.pressKeys(['enter']);
-  await vscode.assert('Data synced successfully');
-});
-```
-
-## Learn More
-
-<CardGroup cols={2}>
-  <Card
-    title="Chrome Preset"
-    icon="chrome"
-    href="/v7/presets/chrome"
-  >
-    Web application testing
-  </Card>
-
-  <Card
-    title="VS Code Preset"
-    icon="code"
-    href="/v7/presets/vscode"
-  >
-    IDE extension testing
-  </Card>
-
-  <Card
-    title="Electron Preset"
-    icon="atom"
-    href="/v7/presets/electron"
-  >
-    Electron app testing
-  </Card>
-
-  <Card
-    title="Chrome Extension"
-    icon="puzzle-piece"
-    href="/v7/presets/chrome-extension"
-  >
-    Browser extension testing
-  </Card>
-
-  <Card
-    title="Platform Support"
-    icon="server"
-    href="/v7/platforms/linux"
-  >
-    Cross-platform documentation
-  </Card>
-
-  <Card
-    title="API Reference"
-    icon="book"
-    href="/v7/api/client"
-  >
-    Complete API documentation
-  </Card>
-</CardGroup>