Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sand4rt/playwright-ct-angular
Playwright Angular component testing.
https://github.com/sand4rt/playwright-ct-angular
angular component component-testing playwright test testing
Last synced: about 2 months ago
JSON representation
Playwright Angular component testing.
- Host: GitHub
- URL: https://github.com/sand4rt/playwright-ct-angular
- Owner: sand4rt
- License: mit
- Archived: true
- Created: 2023-02-27T21:22:45.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-01T09:50:45.000Z (6 months ago)
- Last Synced: 2024-11-10T18:05:51.146Z (2 months ago)
- Topics: angular, component, component-testing, playwright, test, testing
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@sand4rt/experimental-ct-angular
- Size: 177 MB
- Stars: 48
- Watchers: 2
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-angular - playwright-ct-angular - Playwright Angular component testing. (Table of contents / Angular)
- fucking-awesome-angular - playwright-ct-angular - Playwright Angular component testing. (Table of contents / Angular)
- fucking-awesome-angular - playwright-ct-angular - Playwright Angular component testing. (Table of contents / Angular)
README
# 🎠Playwright Angular component testing
> **Note**
> ~~The API has been designed to closely resemble Playwright's API wherever applicable. This library is _(without guarantee)_ aimed at facilitating a smooth transition to Playwright once it offers official support for Angular components. It is important to take into account that this library will reach end of life when Playwright has official support for Angular component testing.~~
>
> ~~To push for official support, feedback in the form of GitHub issues and or stars is appreciated!~~
>
> This library has reached end of life as it is about to be merged into the Playwright repo: https://github.com/microsoft/playwright/pull/27783. To switch to the in-house Playwright version, just replace the `@sand4rt/experimental-ct-angular` imports with `@playwright/experimental-ct-angular`. Thank you all for the support!
## Capabilities
- Run tests fast, in parallel and optionally over multiple machines with [sharding](https://playwright.dev/docs/test-sharding) or [Azure's Testing Service](https://www.youtube.com/watch?v=FvyYC2pxL_8).
- Run the test headless or headed accross multiple _real_ desktop and/or mobile browser engines.
- Full support for shadow DOM, multiple origins, (i)frames, browser tabs and contexts.
- Minimizes flakyness, due to auto waiting, web first assertions and ensures that every test runs in [full isolation](https://playwright.dev/docs/browser-contexts).
- Advanced [emulation capabilities](https://playwright.dev/docs/emulation) such as modifying screen size, geolocation, color scheme and [the network](https://playwright.dev/docs/mock-browser-apis).
- Interactions with the components are indistinguishable from real user behavior.
- [Visual regression / screenshot testing](https://playwright.dev/docs/api/class-pageassertions#page-assertions-to-have-screenshot-1).
- Zero-configuration TypeScript support.
Along with all these ✨ awesome capabilities ✨ that come with Playwright, you will also get:
- [Watch mode _(BETA)_](https://github.com/microsoft/playwright/issues/21960#issuecomment-1483604692).
- [Visual Studio Code intergration](https://playwright.dev/docs/getting-started-vscode).
- [UI mode](https://playwright.dev/docs/test-ui-mode) for debuging tests with a time travel experience complete with watch mode.
- [Playwright Tracing](https://playwright.dev/docs/trace-viewer-intro) for post-mortem debugging in CI.
- [Playwright Test Code generation](https://playwright.dev/docs/codegen-intro) to record and generate tests suites.
## Usage
Initialize Playwright Angular component testing with PNPM, NPM or Yarn and follow the installation steps:
```sh
pnpm create playwright-sand4rt --ct
```
```sh
npm init playwright-sand4rt@latest -- --ct
```
```sh
yarn create playwright-sand4rt --ct
```
Now you can start creating your tests:
```ts
// button.component.ts
import { Component, Input } from '@angular/core';
@Component({
standalone: true,
selector: 'button-component',
template: `{{title}}`,
})
export class ButtonComponent {
@Input() title!: string;
}
```
```jsx
// button.component.test.ts
import { test, expect } from '@sand4rt/experimental-ct-angular';
import { ButtonComponent } from './components/button.component';
test('render props', async ({ mount }) => {
const component = await mount(ButtonComponent, {
props: {
title: 'Submit',
},
});
await expect(component).toContainText('Submit');
});
```
See the official [playwright component testing documentation](https://playwright.dev/docs/test-components) and the [tests](https://github.com/sand4rt/playwright-ct-angular/tree/main/ct-angular/tests) for more information on how to use it.