/**
* Copyright (c) Microsoft Corporation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import { stripVTControlCharacters } from 'node:util';
import { stripAnsi } from '../config/utils';
import { test, expect } from './pageTest';
test.describe('toHaveCount', () => {
test('toHaveCount pass', async ({ page }) => {
await page.setContent('One ');
const locator = page.locator('option');
let done = false;
const promise = expect(locator).toHaveCount(2).then(() => { done = true; });
await page.waitForTimeout(1000);
expect(done).toBe(false);
await page.setContent('One Two ');
await promise;
expect(done).toBe(true);
});
test('pass zero', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('span');
await expect(locator).toHaveCount(0);
await expect(locator).not.toHaveCount(1);
});
test('eventually pass zero', async ({ page }) => {
await page.setContent('hello
');
const locator = page.locator('span');
setTimeout(() => page.evaluate(() => document.querySelector('div').textContent = '').catch(() => {}), 200);
await expect(locator).toHaveCount(0);
await expect(locator).not.toHaveCount(1);
});
test('eventually pass non-zero', async ({ page }) => {
await page.setContent('');
setTimeout(async () => {
await page.setContent('');
}, 500);
const locator = page.locator('li');
await expect(locator).toHaveCount(2);
});
test('eventually pass not non-zero', async ({ page }) => {
await page.setContent('');
setTimeout(async () => {
await page.setContent('');
}, 500);
const locator = page.locator('li');
await expect(locator).not.toHaveCount(2);
});
test('fail zero', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('span');
const error = await expect(locator).toHaveCount(0, { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).toHaveCount(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveCount" with timeout 1000ms`);
});
test('fail zero 2', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('span');
const error = await expect(locator).not.toHaveCount(1, { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).not.toHaveCount(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "not toHaveCount" with timeout 1000ms`);
});
});
test.describe('toHaveJSProperty', () => {
test('pass', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = { a: 1, b: 'string', c: new Date(1627503992000) });
const locator = page.locator('div');
await expect(locator).toHaveJSProperty('foo', { a: 1, b: 'string', c: new Date(1627503992000) });
});
test('fail', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = { a: 1, b: 'string', c: new Date(1627503992000) });
const locator = page.locator('div');
const error = await expect(locator).toHaveJSProperty('foo', { a: 1, b: 'string', c: new Date(1627503992001) }, { timeout: 1000 }).catch(e => e);
expect(error.message).toContain(`- "c"`);
});
test('pass string', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = 'string');
const locator = page.locator('div');
await expect(locator).toHaveJSProperty('foo', 'string');
});
test('fail string', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = 'string');
const locator = page.locator('div');
const error = await expect(locator).toHaveJSProperty('foo', 'error', { timeout: 200 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 200ms waiting for expect(locator).toHaveJSProperty(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveJSProperty" with timeout 200ms`);
});
test('pass number', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = 2021);
const locator = page.locator('div');
await expect(locator).toHaveJSProperty('foo', 2021);
});
test('fail number', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = 2021);
const locator = page.locator('div');
const error = await expect(locator).toHaveJSProperty('foo', 1, { timeout: 200 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 200ms waiting for expect(locator).toHaveJSProperty(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveJSProperty" with timeout 200ms`);
});
test('pass boolean', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = true);
const locator = page.locator('div');
await expect(locator).toHaveJSProperty('foo', true);
});
test('fail boolean', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = false);
const locator = page.locator('div');
const error = await expect(locator).toHaveJSProperty('foo', true, { timeout: 200 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 200ms waiting for expect(locator).toHaveJSProperty(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveJSProperty" with timeout 200ms`);
});
test('pass boolean 2', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = false);
const locator = page.locator('div');
await expect(locator).toHaveJSProperty('foo', false);
});
test('fail boolean 2', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = false);
const locator = page.locator('div');
const error = await expect(locator).toHaveJSProperty('foo', true, { timeout: 200 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 200ms waiting for expect(locator).toHaveJSProperty(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveJSProperty" with timeout 200ms`);
});
test('pass undefined', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
await expect(locator).toHaveJSProperty('foo', undefined);
});
test('pass null', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = null);
const locator = page.locator('div');
await expect(locator).toHaveJSProperty('foo', null);
});
test('pass nested', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = { nested: { a: 1, b: 'string', c: new Date(1627503992000) } });
const locator = page.locator('div');
await expect(locator).toHaveJSProperty('foo.nested', { a: 1, b: 'string', c: new Date(1627503992000) });
await expect(locator).toHaveJSProperty('foo.nested.a', 1);
await expect(locator).toHaveJSProperty('foo.nested.b', 'string');
await expect(locator).toHaveJSProperty('foo.nested.c', new Date(1627503992000));
});
test('fail nested', async ({ page }) => {
await page.setContent('
');
await page.$eval('div', e => (e as any).foo = { nested: { a: 1, b: 'string', c: new Date(1627503992000) } });
const locator = page.locator('div');
const error1 = await expect(locator).toHaveJSProperty('foo.bar', { a: 1, b: 'string', c: new Date(1627503992001) }, { timeout: 1000 }).catch(e => e);
expect.soft(stripAnsi(error1.message)).toContain(`Received: undefined`);
const error2 = await expect(locator).toHaveJSProperty('foo.nested.a', 2, { timeout: 1000 }).catch(e => e);
expect.soft(stripAnsi(error2.message)).toContain(`Received: 1`);
});
});
test.describe('toHaveClass', () => {
test('pass', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
await expect(locator).toHaveClass('foo bar baz');
});
test('pass with SVGs', async ({ page }) => {
await page.setContent(` `);
await expect(page.locator('svg')).toHaveClass(/c1/);
});
test('fail', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
const error = await expect(locator).toHaveClass('foo bar baz', { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).toHaveClass(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveClass" with timeout 1000ms`);
});
test('pass with array', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
await expect(locator).toHaveClass(['foo', 'bar', /[a-z]az/]);
});
test('fail with array', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
const error = await expect(locator).toHaveClass(['foo', 'bar', /[a-z]az/], { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).toHaveClass(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveClass" with timeout 1000ms`);
});
});
test.describe('toContainClass', () => {
test('pass', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
await expect(locator).toContainClass('');
await expect(locator).toContainClass('bar');
await expect(locator).toContainClass('baz bar');
await expect(locator).toContainClass(' bar foo ');
await expect(locator).not.toContainClass(' baz not-matching '); // Strip whitespace and match individual classes
expect(() => expect(locator).toContainClass(/foo|bar/ as any)).toThrow(/"expected\" argument in toContainClass cannot be a RegExp value/);
});
test('pass with SVGs', async ({ page }) => {
await page.setContent(` `);
await expect(page.locator('svg')).toContainClass('c1');
});
test('fail', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
const error = await expect(locator).toContainClass('does-not-exist', { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).toContainClass(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toContainClass" with timeout 1000ms`);
});
test('pass with array', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
await expect(locator).toContainClass(['foo', 'hello', 'baz']);
expect(() => expect(locator).toContainClass(['foo', 'hello', /baz/] as any)).toThrow(/"expected" argument in toContainClass cannot contain RegExp values/);
await expect(locator).not.toHaveClass(['not-there', 'hello', 'baz']); // Class not there
await expect(locator).not.toHaveClass(['foo', 'hello']); // Length mismatch
});
test('fail with array', async ({ page }) => {
await page.setContent('
');
const locator = page.locator('div');
const error = await expect(locator).toContainClass(['foo', 'bar', 'baz'], { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).toContainClass(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toContainClass" with timeout 1000ms`);
});
});
test.describe('toHaveTitle', () => {
test('pass', async ({ page }) => {
await page.setContent(' Hello world ');
await expect(page).toHaveTitle('Hello world');
});
test('fail', async ({ page }) => {
await page.setContent('Bye ');
const error = await expect(page).toHaveTitle('Hello', { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(page).toHaveTitle(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveTitle" with timeout 1000ms`);
});
});
test.describe('toHaveURL', () => {
test('pass', async ({ page }) => {
await page.goto('data:text/html,A
');
await expect(page).toHaveURL('data:text/html,A
');
});
test('fail string', async ({ page }) => {
await page.goto('data:text/html,A
');
const error = await expect(page).toHaveURL('wrong', { timeout: 1000 }).catch(e => e);
expect(stripVTControlCharacters(error.message)).toContain('Timed out 1000ms waiting for expect(locator).toHaveURL(expected)');
expect(stripVTControlCharacters(error.message)).toContain('Expected string: "wrong"\nReceived string: "data:text/html,A
"');
});
test('fail with invalid argument', async ({ page }) => {
await page.goto('data:text/html,A
');
// @ts-expect-error
const error = await expect(page).toHaveURL({}).catch(e => e);
expect(stripVTControlCharacters(error.message)).toContain(`expect(locator(':root')).toHaveURL([object Object])`);
expect(stripVTControlCharacters(error.message)).toContain('Expected has type: object\nExpected has value: {}');
});
test('fail with positive predicate', async ({ page }) => {
await page.goto('data:text/html,A
');
const error = await expect(page).toHaveURL(_url => false).catch(e => e);
expect(stripVTControlCharacters(error.message)).toContain('expect(page).toHaveURL(expected)');
expect(stripVTControlCharacters(error.message)).toContain('Expected predicate to succeed\nReceived string: "data:text/html,A
"');
});
test('fail with negative predicate', async ({ page }) => {
await page.goto('data:text/html,A
');
const error = await expect(page).not.toHaveURL(_url => true).catch(e => e);
expect(stripVTControlCharacters(error.message)).toContain('expect(page).not.toHaveURL(expected)');
expect(stripVTControlCharacters(error.message)).toContain('Expected predicate to fail\nReceived string: "data:text/html,A
"');
});
test('resolve predicate on initial call', async ({ page }) => {
await page.goto('data:text/html,A
');
await expect(page).toHaveURL(url => url.href === 'data:text/html,A
', { timeout: 1000 });
});
test('resolve predicate after retries', async ({ page }) => {
await page.goto('data:text/html,A
');
const expectPromise = expect(page).toHaveURL(url => url.href === 'data:text/html,B
', { timeout: 1000 });
setTimeout(() => page.goto('data:text/html,B
'), 500);
await expectPromise;
});
test('support ignoreCase', async ({ page }) => {
await page.goto('data:text/html,A
');
await expect(page).toHaveURL('DATA:teXT/HTml,a
', { ignoreCase: true });
});
});
test.describe('toHaveAttribute', () => {
test('pass', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#node');
await expect(locator).toHaveAttribute('id', 'node');
});
test('should not match missing attribute', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#node');
{
const error = await expect(locator).toHaveAttribute('disabled', '', { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).toHaveAttribute(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveAttribute" with timeout 1000ms`);
}
{
const error = await expect(locator).toHaveAttribute('disabled', /.*/, { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).toHaveAttribute(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "toHaveAttribute" with timeout 1000ms`);
}
await expect(locator).not.toHaveAttribute('disabled', '');
await expect(locator).not.toHaveAttribute('disabled', /.*/);
});
test('should match boolean attribute', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#node');
await expect(locator).toHaveAttribute('checked', '');
await expect(locator).toHaveAttribute('checked', /.*/);
{
const error = await expect(locator).not.toHaveAttribute('checked', '', { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).not.toHaveAttribute(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "not toHaveAttribute" with timeout 1000ms`);
}
{
const error = await expect(locator).not.toHaveAttribute('checked', /.*/, { timeout: 1000 }).catch(e => e);
expect(stripAnsi(error.message)).toContain(`Timed out 1000ms waiting for expect(locator).not.toHaveAttribute(expected)`);
expect(stripAnsi(error.message)).toContain(`- Expect "not toHaveAttribute" with timeout 1000ms`);
}
});
test('should match attribute without value', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#node');
await expect(locator).toHaveAttribute('id');
await expect(locator).toHaveAttribute('checked');
await expect(locator).not.toHaveAttribute('open');
});
test('should support boolean attribute with options', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#node');
await expect(locator).toHaveAttribute('id', { timeout: 5000 });
await expect(locator).toHaveAttribute('checked', { timeout: 5000 });
await expect(locator).not.toHaveAttribute('open', { timeout: 5000 });
});
test('support ignoreCase', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#NoDe');
await expect(locator).toHaveAttribute('id', 'node', { ignoreCase: true });
await expect(locator).not.toHaveAttribute('id', 'node');
});
});
test.describe('toHaveCSS', () => {
test('pass', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#node');
await expect(locator).toHaveCSS('color', 'rgb(255, 0, 0)');
});
test('custom css properties', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#node');
await expect(locator).toHaveCSS('--custom-color-property', '#FF00FF');
});
});
test.describe('toHaveId', () => {
test('pass', async ({ page }) => {
await page.setContent('Text content
');
const locator = page.locator('#node');
await expect(locator).toHaveId('node');
});
});
test.describe('toBeInViewport', () => {
test('should work', async ({ page }) => {
await page.setContent(`
foo
`);
await expect(page.locator('#big')).toBeInViewport();
await expect(page.locator('#small')).not.toBeInViewport();
await page.locator('#small').scrollIntoViewIfNeeded();
await expect(page.locator('#small')).toBeInViewport();
await expect(page.locator('#small')).toBeInViewport({ ratio: 1 });
});
test('should respect ratio option', async ({ page, isAndroid }) => {
test.fixme(isAndroid, 'ratio 0.24 is not in viewport for unknown reason');
await page.setContent(`
`);
await expect(page.locator('div')).toBeInViewport();
await expect(page.locator('div')).toBeInViewport({ ratio: 0.1 });
await expect(page.locator('div')).toBeInViewport({ ratio: 0.2 });
await expect(page.locator('div')).toBeInViewport({ ratio: 0.24 });
// In this test, element's ratio is 0.25.
await expect(page.locator('div')).toBeInViewport({ ratio: 0.25 });
await expect(page.locator('div')).not.toBeInViewport({ ratio: 0.26 });
await expect(page.locator('div')).not.toBeInViewport({ ratio: 0.3 });
await expect(page.locator('div')).not.toBeInViewport({ ratio: 0.7 });
await expect(page.locator('div')).not.toBeInViewport({ ratio: 0.8 });
});
test('should have good stack', async ({ page }) => {
let error;
try {
await expect(page.locator('body')).not.toBeInViewport({ timeout: 100 });
} catch (e) {
error = e;
}
expect(error).toBeTruthy();
expect(/unexpected value "viewport ratio \d+/.test(error.stack)).toBe(true);
const stackFrames = error.stack.split('\n').filter(line => line.trim().startsWith('at '));
expect(stackFrames.length).toBe(1);
expect(stackFrames[0]).toContain(__filename);
});
test('should report intersection even if fully covered by other element', async ({ page }) => {
await page.setContent(`
hello
')).not.toContain(waitingForMessage);
});
test('toHaveText should not produce logs twice', async ({ page }) => {
await page.setContent('
hello
');
const error = await expect(page.locator('div')).toHaveText('world', { timeout: 2000 }).catch(e => e);
const waitingForMessage = `waiting for locator('div')`;
expect(error.message).toContain(waitingForMessage);
expect(error.message).toContain(`locator resolved to
hello
`);
expect(error.message).toContain(`unexpected value "hello"`);
expect(error.message.replace(waitingForMessage, '
')).not.toContain(waitingForMessage);
});
test('toHaveText that does not match should not produce logs twice', async ({ page }) => {
await page.setContent('hello
');
const error = await expect(page.locator('span')).toHaveText('world', { timeout: 2000 }).catch(e => e);
const waitingForMessage = `waiting for locator('span')`;
expect(error.message).toContain(waitingForMessage);
expect(error.message).not.toContain('locator resolved to');
expect(error.message.replace(waitingForMessage, '')).not.toContain(waitingForMessage);
});