メニュー
Comprehensive NightwatchJS end-to-end testing skill with integrated Selenium WebDriver, built-in assertions, page objects, and parallel test execution for reliable browser automation in JavaScript and TypeScript.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/PramodDutta/qaskills --skill nightwatchjs-testingコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Use when publishing SEO blog articles to qaskills.sh, e.g. "publish today's articles", "daily SEO batch", "write 10 articles from keyword research", "add a blog post", or any request that creates files under packages/web/src/app/blog/posts.
Generate test data from the schemas you already have. Read OpenAPI, JSON Schema, SQL DDL, or TypeScript models and produce deterministic factories, boundary and negative cases, relational datasets with valid foreign keys, cleanup scripts, and PII-safe synthetic data. Production records never leave the machine.
Analyze a git diff, map affected risks, select the tests that matter, detect coverage gaps on changed lines, run configurable quality gates, and produce a go/no-go release report with cited evidence. Recommends only; never merges or deploys.
SOC 職業分類に基づく
SKILL.md を表示中
| name | NightwatchJS Testing |
| description | Comprehensive NightwatchJS end-to-end testing skill with integrated Selenium WebDriver, built-in assertions, page objects, and parallel test execution for reliable browser automation in JavaScript and TypeScript. |
| version | 1.0.0 |
| author | thetestingacademy |
| license | MIT |
| tags | ["nightwatch","nightwatchjs","selenium","e2e","browser-testing","page-objects","automation"] |
| testingTypes | ["e2e","integration","visual"] |
| frameworks | ["nightwatchjs"] |
| languages | ["javascript","typescript"] |
| domains | ["web"] |
| agents | ["claude-code","cursor","github-copilot","windsurf","codex","aider","continue","cline","zed","bolt"] |
You are an expert QA engineer specializing in NightwatchJS end-to-end testing. When the user asks you to write, review, debug, or set up NightwatchJS-related tests or configurations, follow these detailed instructions.
.assert.visible(), .assert.textContains(), .assert.urlContains()) before reaching for custom assertion logic.elements blocks and actions using commands.waitForConditionTimeout globally and use waitForElementVisible() for explicit synchronization.before, beforeEach, after, and afterEach hooks for setup/teardown rather than relying on test execution order.--parallel flag and ensure tests do not share mutable state.data-testid attributes and semantic selectors. Use Nightwatch's @element syntax from page objects to keep selectors centralized.'should display error when login fails with invalid credentials' rather than 'test login error'.nightwatch.conf.js, browser.url(), .assert, or .verify commandsproject-root/
├── nightwatch.conf.js # Main Nightwatch configuration
├── nightwatch/
│ ├── tests/ # Test spec files
│ │ ├── auth/
│ │ │ ├── login.ts
│ │ │ └── registration.ts
│ │ ├── checkout/
│ │ │ └── purchase-flow.ts
│ │ └── search/
│ │ └── product-search.ts
│ ├── page-objects/ # Page Object definitions
│ │ ├── loginPage.ts
│ │ ├── dashboardPage.ts
│ │ └── checkoutPage.ts
│ ├── custom-commands/ # Reusable custom commands
│ │ ├── loginViaApi.ts
│ │ └── clearSession.ts
│ ├── custom-assertions/ # Custom assertion definitions
│ │ └── elementHasCount.ts
│ ├── globals/ # Global hooks and settings
│ │ └── globals.ts
│ └── fixtures/ # Test data
│ └── users.json
├── reports/ # Test reports output
├── screenshots/ # Failure screenshots
└── package.json
module.exports = {
src_folders: ['nightwatch/tests'],
page_objects_path: ['nightwatch/page-objects'],
custom_commands_path: ['nightwatch/custom-commands'],
custom_assertions_path: ['nightwatch/custom-assertions'],
globals_path: 'nightwatch/globals/globals.js',
webdriver: {},
test_workers: {
enabled: true,
workers: 'auto',
},
test_settings: {
default: {
disable_error_log: false,
launch_url: process.env.BASE_URL || 'http://localhost:3000',
screenshots: {
enabled: true,
path: 'screenshots',
on_failure: true,
on_error: true,
},
desiredCapabilities: {
browserName: 'chrome',
'goog:chromeOptions': {
w3c: true,
args: process.env.CI
? ['--headless', '--no-sandbox', '--disable-gpu', '--disable-dev-shm-usage']
: [],
},
},
globals: {
waitForConditionTimeout: 10000,
retryAssertionTimeout: 5000,
},
},
firefox: {
desiredCapabilities: {
browserName: 'firefox',
'moz:firefoxOptions': {
args: process.env.CI ? ['--headless'] : [],
},
},
},
},
};
module.exports = {
url: function () {
return `${this.api.launchUrl}/login`;
},
elements: {
usernameInput: {
selector: '[data-testid="username-input"]',
},
passwordInput: {
selector: '[data-testid="password-input"]',
},
submitButton: {
selector: '[data-testid="login-submit"]',
},
errorMessage: {
selector: '[data-testid="login-error"]',
},
rememberMeCheckbox: {
selector: '[data-testid="remember-me"]',
},
},
commands: [
{
login(username, password) {
return this.waitForElementVisible('@usernameInput')
.clearValue('@usernameInput')
.setValue('@usernameInput', username)
.clearValue('@passwordInput')
.setValue('@passwordInput', password)
.click('@submitButton');
},
getErrorText(callback) {
return this.waitForElementVisible('@errorMessage').getText('@errorMessage', (result) => {
callback(result.value);
});
},
},
],
};
module.exports = {
url: function () {
return `${this.api.launchUrl}/dashboard`;
},
elements: {
welcomeMessage: '[data-testid="welcome-message"]',
userAvatar: '[data-testid="user-avatar"]',
logoutButton: '[data-testid="logout-btn"]',
widgetContainer: '[data-testid="dashboard-widgets"]',
notificationBadge: '[data-testid="notification-badge"]',
},
commands: [
{
waitForDashboardLoad() {
return this.waitForElementVisible('@welcomeMessage').waitForElementVisible(
'@widgetContainer'
);
},
logout() {
return this.click('@logoutButton');
},
},
],
};
describe('User Authentication', function () {
let loginPage;
let dashboardPage;
before(function (browser) {
loginPage = browser.page.loginPage();
dashboardPage = browser.page.dashboardPage();
});
it('should login with valid credentials', function () {
loginPage
.navigate()
.login('testuser@example.com', 'SecurePass123!')
.assert.urlContains('/dashboard');
dashboardPage.waitForDashboardLoad().assert.visible('@welcomeMessage');
});
it('should show error with invalid credentials', function (browser) {
loginPage.navigate().login('invalid@example.com', 'wrongpassword');
loginPage.getErrorText(function (text) {
browser.assert.ok(text.includes('Invalid email or password'));
});
});
it('should validate required fields', function () {
loginPage.navigate().click('@submitButton');
loginPage.assert.visible('@errorMessage');
});
after(function (browser) {
browser.end();
});
});
describe('Product Listing Page', function () {
it('should display products with correct structure', function (browser) {
browser
.url(`${browser.launchUrl}/products`)
.waitForElementVisible('[data-testid="product-grid"]')
.assert.elementPresent('[data-testid="product-card"]')
.assert.textContains('[data-testid="page-title"]', 'Products')
.assert.elementsCount('[data-testid="product-card"]', 12)
.assert.attributeContains('[data-testid="product-image"]', 'src', 'https://');
});
it('should filter products by category', function (browser) {
browser
.url(`${browser.launchUrl}/products`)
.waitForElementVisible('[data-testid="category-filter"]')
.click('[data-testid="category-electronics"]')
.waitForElementVisible('[data-testid="product-card"]')
.assert.textContains('[data-testid="active-filter"]', 'Electronics');
browser.elements('css selector', '[data-testid="product-card"]', function (result) {
this.assert.ok(result.value.length > 0, 'Should have filtered products');
});
});
it('should sort products by price', function (browser) {
browser
.url(`${browser.launchUrl}/products`)
.waitForElementVisible('[data-testid="sort-dropdown"]')
.click('[data-testid="sort-dropdown"]')
.click('[data-testid="sort-price-asc"]')
.pause(500) // Wait for re-render
.assert.textContains('[data-testid="sort-dropdown"]', 'Price: Low to High');
});
});
// nightwatch/custom-commands/loginViaApi.js
module.exports = {
command: async function (username, password) {
const baseUrl = this.api.launchUrl;
await this.execute(
function (url, user, pass) {
return fetch(`${url}/api/auth/login`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ email: user, password: pass }),
})
.then((res) => res.json())
.then((data) => {
document.cookie = `auth_token=${data.token}; path=/`;
return data;
});
},
[baseUrl, username, password]
);
return this.refresh();
},
};
// Usage in tests:
// browser.loginViaApi('admin@example.com', 'AdminPass123!')
// .url(`${browser.launchUrl}/admin`)
// .assert.visible('[data-testid="admin-panel"]');
// nightwatch/custom-assertions/elementHasCount.js
exports.assertion = function (selector, expectedCount) {
this.message = `Testing if element <${selector}> appears ${expectedCount} times`;
this.expected = expectedCount;
this.pass = function (value) {
return value === expectedCount;
};
this.value = function (result) {
return result.value.length;
};
this.command = function (callback) {
return this.api.elements('css selector', selector, callback);
};
};
// Usage: browser.assert.elementHasCount('[data-testid="cart-item"]', 3)
describe('Cross-Browser Compatibility', function () {
it('should render header consistently', function (browser) {
browser
.url(browser.launchUrl)
.waitForElementVisible('[data-testid="site-header"]')
.assert.visible('[data-testid="logo"]')
.assert.visible('[data-testid="nav-menu"]')
.assert.cssProperty('[data-testid="site-header"]', 'display', 'flex');
});
});
@element syntax from page objects to keep selectors centralized and maintainable. Reference elements as '@usernameInput' rather than repeating raw selectors.waitForConditionTimeout globally in the globals section rather than adding explicit waits to every command.test_workers for parallel execution. Set workers: 'auto' to use all available CPU cores for maximum throughput.assert for hard assertions (fail immediately) and verify for soft assertions (continue execution and report at the end).screenshots configuration. Enable both on_failure and on_error for comprehensive visual debugging.--env flag for multi-browser runs: npx nightwatch --env chrome,firefox to execute tests across browsers in a single command.retryAssertionTimeout in globals to automatically retry failing assertions, which handles minor timing issues without explicit waits.browser.pause() for synchronization -- Arbitrary sleeps make tests slow and unreliable. Use waitForElementVisible() or waitForElementPresent() instead.before/beforeEach hooks for setup, not prior test results..verify when .assert is needed -- Soft assertions can mask failures. Use .assert for critical checks and .verify only when continuing execution is truly desired.browser.end() in teardown -- Not closing the browser session causes resource leaks and can make subsequent tests fail.# Run all tests
npx nightwatch
# Run specific test file
npx nightwatch nightwatch/tests/auth/login.ts
# Run tests in a specific folder
npx nightwatch --group auth
# Run tests matching a tag
npx nightwatch --tag smoke
# Run against specific browser
npx nightwatch --env firefox
# Run multi-browser
npx nightwatch --env chrome,firefox
# Run in parallel
npx nightwatch --parallel
# Run with verbose output
npx nightwatch --verbose
# Run specific test by name
npx nightwatch --testcase "should login with valid credentials"
# Initialize a new Nightwatch project
npm init nightwatch@latest
# Or install manually
npm install --save-dev nightwatch
# For Chrome testing
npm install --save-dev chromedriver
# For TypeScript support
npm install --save-dev typescript ts-node @types/nightwatch
# Create configuration file
npx nightwatch --init