mirror of
https://github.com/microsoft/playwright.git
synced 2024-09-11 20:37:54 +03:00
docs: spelling (#31779)
Fixes misspellings identified by the [check-spelling
action](https://github.com/marketplace/actions/check-spelling).
The misspellings have been reported at
https://github.com/jsoref/playwright/actions/runs/10015023629#summary-27685777352
The action will report that the changes in this PR would make it happy:
https://github.com/jsoref/playwright/actions/runs/10015023971#summary-27685778305
---
I understand that the commit messages will need to be reworded to match
house style. For the time being, these are merely noting the changes
they contain so that when I rebase or need to drop things, I can. --
I've already rebased once as someone fixed one of the items that my
draft work was going to fix.
---
## Testing
* The tests _mostly_ passed when I managed to trigger them, but there
were a handful of things that I didn't quite understand
* There are a large number of warnings relating to a bad interaction
between any workflow that uses this local action
b535139b32/.github/actions/run-test/action.yml (L74-L80)
and the action it calls -- I've opened Azure/login#474 asking them to
refactor their action so that it doesn't cause so much noise while
running this repository's tests
* I'm vaguely curious as to why this repository has a `branch`
constraint for its `pull_request` events in its workflows -- that
constraint gave me a number of additional headaches while trying to
prepare this branch for this PR.
---------
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
This commit is contained in:
parent
af3d2ba9fe
commit
7abbbd0c84
@ -135,7 +135,7 @@ If the element in question is used repeatedly in many pages, consider [using a t
|
||||
|
||||
### Disabling individual scan rules
|
||||
|
||||
If your application contains many different pre-existing violations of a specific rule, you can use [`AxeBuilder.disableRules()`](https://github.com/dequelabs/axe-core-maven-html/blob/develop/playwright/README.md#axebuilderdisablerulesliststring-rules) to temporarily disable individual rules until you're able to fix the issues.
|
||||
If your application contains many different preexisting violations of a specific rule, you can use [`AxeBuilder.disableRules()`](https://github.com/dequelabs/axe-core-maven-html/blob/develop/playwright/README.md#axebuilderdisablerulesliststring-rules) to temporarily disable individual rules until you're able to fix the issues.
|
||||
|
||||
You can find the rule IDs to pass to `disableRules()` in the `id` property of the violations you want to suppress. A [complete list of axe's rules](https://github.com/dequelabs/axe-core/blob/master/doc/rule-descriptions.md) can be found in `axe-core`'s documentation.
|
||||
|
||||
|
@ -147,7 +147,7 @@ If the element in question is used repeatedly in many pages, consider [using a t
|
||||
|
||||
### Disabling individual scan rules
|
||||
|
||||
If your application contains many different pre-existing violations of a specific rule, you can use [`AxeBuilder.disableRules()`](https://github.com/dequelabs/axe-core-npm/blob/develop/packages/playwright/README.md#axebuilderdisablerulesrules-stringarray) to temporarily disable individual rules until you're able to fix the issues.
|
||||
If your application contains many different preexisting violations of a specific rule, you can use [`AxeBuilder.disableRules()`](https://github.com/dequelabs/axe-core-npm/blob/develop/packages/playwright/README.md#axebuilderdisablerulesrules-stringarray) to temporarily disable individual rules until you're able to fix the issues.
|
||||
|
||||
You can find the rule IDs to pass to `disableRules()` in the `id` property of the violations you want to suppress. A [complete list of axe's rules](https://github.com/dequelabs/axe-core/blob/master/doc/rule-descriptions.md) can be found in `axe-core`'s documentation.
|
||||
|
||||
@ -167,7 +167,7 @@ test('should not have any accessibility violations outside of rules with known i
|
||||
|
||||
### Using snapshots to allow specific known issues
|
||||
|
||||
If you would like to allow for a more granular set of known issues, you can use [Snapshots](./test-snapshots.md) to verify that a set of pre-existing violations has not changed. This approach avoids the downsides of using `AxeBuilder.exclude()` at the cost of slightly more complexity and fragility.
|
||||
If you would like to allow for a more granular set of known issues, you can use [Snapshots](./test-snapshots.md) to verify that a set of preexisting violations has not changed. This approach avoids the downsides of using `AxeBuilder.exclude()` at the cost of slightly more complexity and fragility.
|
||||
|
||||
Do not use a snapshot of the entire `accessibilityScanResults.violations` array. It contains implementation details of the elements in question, such as a snippet of their rendered HTML; if you include these in your snapshots, it will make your tests prone to breaking every time one of the components in question changes for an unrelated reason:
|
||||
|
||||
|
@ -154,7 +154,7 @@ Raw JavaScript content to be injected into frame.
|
||||
* since: v1.8
|
||||
- `type` <[string]>
|
||||
|
||||
Script type. Use 'module' in order to load a Javascript ES6 module. See
|
||||
Script type. Use 'module' in order to load a JavaScript ES6 module. See
|
||||
[script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
|
||||
|
||||
## async method: Frame.addStyleTag
|
||||
|
@ -688,7 +688,7 @@ Raw JavaScript content to be injected into frame.
|
||||
* since: v1.8
|
||||
- `type` <[string]>
|
||||
|
||||
Script type. Use 'module' in order to load a Javascript ES6 module. See
|
||||
Script type. Use 'module' in order to load a JavaScript ES6 module. See
|
||||
[script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
|
||||
|
||||
## async method: Page.addStyleTag
|
||||
@ -2312,7 +2312,7 @@ Attribute name to get the value for.
|
||||
- returns: <[null]|[Response]>
|
||||
|
||||
Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
|
||||
last redirect. If can not go back, returns `null`.
|
||||
last redirect. If cannot go back, returns `null`.
|
||||
|
||||
Navigate to the previous page in history.
|
||||
|
||||
@ -2330,7 +2330,7 @@ Navigate to the previous page in history.
|
||||
- returns: <[null]|[Response]>
|
||||
|
||||
Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
|
||||
last redirect. If can not go forward, returns `null`.
|
||||
last redirect. If cannot go forward, returns `null`.
|
||||
|
||||
Navigate to the next page in history.
|
||||
|
||||
|
@ -59,7 +59,7 @@ namespace PlaywrightTests;
|
||||
public class ExampleTests : PageTest
|
||||
{
|
||||
[TestMethod]
|
||||
public async Task NavigatetoLoginPage()
|
||||
public async Task NavigateToLoginPage()
|
||||
{
|
||||
await Page.GetByRole(AriaRole.Button, new() { Name = "Sign In" }).ClickAsync();
|
||||
await Expect(Page).ToHaveURLAsync(new Regex(".*/login"));
|
||||
|
@ -124,7 +124,7 @@ Headers with multiple entries, such as `Set-Cookie`, appear in the array multipl
|
||||
* since: v1.15
|
||||
- returns: <[null]|[string]>
|
||||
|
||||
Returns the value of the header matching the name. The name is case insensitive.
|
||||
Returns the value of the header matching the name. The name is case-insensitive.
|
||||
|
||||
### param: Request.headerValue.name
|
||||
* since: v1.15
|
||||
|
@ -59,7 +59,7 @@ Headers with multiple entries, such as `Set-Cookie`, appear in the array multipl
|
||||
* since: v1.15
|
||||
- returns: <[null]|[string]>
|
||||
|
||||
Returns the value of the header matching the name. The name is case insensitive. If multiple headers have
|
||||
Returns the value of the header matching the name. The name is case-insensitive. If multiple headers have
|
||||
the same name (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\n` separator is used. If no headers are found, `null` is returned.
|
||||
|
||||
### param: Response.headerValue.name
|
||||
@ -72,7 +72,7 @@ Name of the header.
|
||||
* since: v1.15
|
||||
- returns: <[Array]<[string]>>
|
||||
|
||||
Returns all values of the headers matching the name, for example `set-cookie`. The name is case insensitive.
|
||||
Returns all values of the headers matching the name, for example `set-cookie`. The name is case-insensitive.
|
||||
|
||||
### param: Response.headerValues.name
|
||||
* since: v1.15
|
||||
|
@ -263,7 +263,7 @@ existing authentication state instead.
|
||||
Playwright provides a way to reuse the signed-in state in the tests. That way you can log
|
||||
in only once and then skip the log in step for all of the tests.
|
||||
|
||||
Web apps use cookie-based or token-based authentication, where authenticated state is stored as [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies) or in [local storage](https://developer.mozilla.org/en-US/docs/Web/API/Storage). Playwright provides [`method: BrowserContext.storageState`] method that can be used to retrieve storage state from authenticated contexts and then create new contexts with pre-populated state.
|
||||
Web apps use cookie-based or token-based authentication, where authenticated state is stored as [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies) or in [local storage](https://developer.mozilla.org/en-US/docs/Web/API/Storage). Playwright provides [`method: BrowserContext.storageState`] method that can be used to retrieve storage state from authenticated contexts and then create new contexts with prepopulated state.
|
||||
|
||||
Cookies and local storage state can be used across different browsers. They depend on your application's authentication model: some apps might require both cookies and local storage.
|
||||
|
||||
|
@ -43,7 +43,7 @@ You can also reuse the signed-in state in the tests with [setup project](./auth.
|
||||
|
||||
### Avoid testing third-party dependencies
|
||||
|
||||
Only test what you control. Don't try to test links to external sites or third party servers that you do not control. Not only is it time consuming and can slow down your tests but also you can not control the content of the page you are linking to, or if there are cookie banners or overlay pages or anything else that might cause your test to fail.
|
||||
Only test what you control. Don't try to test links to external sites or third party servers that you do not control. Not only is it time consuming and can slow down your tests but also you cannot control the content of the page you are linking to, or if there are cookie banners or overlay pages or anything else that might cause your test to fail.
|
||||
|
||||
Instead, use the [Playwright Network API](/network.md#handle-requests) and guarantee the response needed.
|
||||
|
||||
@ -215,7 +215,7 @@ Playwright comes with a range of tooling to help you write tests.
|
||||
- The [test generator](./codegen.md) can generate tests and pick locators for you.
|
||||
- The [trace viewer](./trace-viewer.md) gives you a full trace of your tests as a local PWA that can easily be shared. With the trace viewer you can view the timeline, inspect DOM snapshots for each action, view network requests and more.
|
||||
- The [UI Mode](./test-ui-mode) lets you explore, run and debug tests with a time travel experience complete with watch mode. All test files are loaded into the testing sidebar where you can expand each file and describe block to individually run, view, watch and debug each test.
|
||||
- [Typescript](./test-typescript) in Playwright works out of the box and gives you better IDE integrations. Your IDE will show you everything you can do and highlight when you do something wrong. No TypeScript experience is needed and it is not necessary for your code to be in TypeScript, all you need to do is create your tests with a `.ts` extension.
|
||||
- [TypeScript](./test-typescript) in Playwright works out of the box and gives you better IDE integrations. Your IDE will show you everything you can do and highlight when you do something wrong. No TypeScript experience is needed and it is not necessary for your code to be in TypeScript, all you need to do is create your tests with a `.ts` extension.
|
||||
|
||||
### Test across all browsers
|
||||
|
||||
|
@ -763,7 +763,7 @@ pwsh bin/Debug/netX/playwright.ps1 install
|
||||
Playwright downloads Chromium, WebKit and Firefox browsers into the OS-specific cache folders:
|
||||
|
||||
- `%USERPROFILE%\AppData\Local\ms-playwright` on Windows
|
||||
- `~/Library/Caches/ms-playwright` on MacOS
|
||||
- `~/Library/Caches/ms-playwright` on macOS
|
||||
- `~/.cache/ms-playwright` on Linux
|
||||
|
||||
These browsers will take a few hundred megabytes of disk space when installed:
|
||||
|
@ -1012,7 +1012,7 @@ Read more in [our documentation](./test-assertions).
|
||||
|
||||
### Announcements
|
||||
|
||||
- v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update MacOS to keep using latest & greatest WebKit!
|
||||
- v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update macOS to keep using latest & greatest WebKit!
|
||||
|
||||
### Browser Versions
|
||||
|
||||
|
@ -1008,7 +1008,7 @@ This version was also tested against the following stable channels:
|
||||
|
||||
### Announcements
|
||||
|
||||
- v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update MacOS to keep using latest & greatest WebKit!
|
||||
- v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update macOS to keep using latest & greatest WebKit!
|
||||
|
||||
### Browser Versions
|
||||
|
||||
|
@ -1841,7 +1841,7 @@ This version was also tested against the following stable channels:
|
||||
|
||||
- We now ship a designated Python docker image `mcr.microsoft.com/playwright/python`. Please switch over to it if you use
|
||||
Python. This is the last release that includes Python inside our javascript `mcr.microsoft.com/playwright` docker image.
|
||||
- v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update MacOS to keep using latest & greatest WebKit!
|
||||
- v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update macOS to keep using latest & greatest WebKit!
|
||||
|
||||
### Browser Versions
|
||||
|
||||
|
@ -969,7 +969,7 @@ This version was also tested against the following stable channels:
|
||||
|
||||
- We now ship a designated Python docker image `mcr.microsoft.com/playwright/python`. Please switch over to it if you use
|
||||
Python. This is the last release that includes Python inside our javascript `mcr.microsoft.com/playwright` docker image.
|
||||
- v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update MacOS to keep using latest & greatest WebKit!
|
||||
- v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update macOS to keep using latest & greatest WebKit!
|
||||
|
||||
### Browser Versions
|
||||
|
||||
|
@ -21,7 +21,7 @@ Playwright's inspection and routing of requests made by Service Workers are **ex
|
||||
|
||||
Set the `PW_EXPERIMENTAL_SERVICE_WORKER_NETWORK_EVENTS` environment variable to `1` (or any other value) to enable the feature. Only Chrome/Chromium are currently supported.
|
||||
|
||||
If you're using (or are interested in using this this feature), please comment on [this issue](https://github.com/microsoft/playwright/issues/15684) letting us know your use case.
|
||||
If you're using (or are interested in using this feature), please comment on [this issue](https://github.com/microsoft/playwright/issues/15684) letting us know your use case.
|
||||
|
||||
## Service Worker Fetch
|
||||
|
||||
|
@ -158,7 +158,7 @@ export default defineConfig({
|
||||
certs: [{
|
||||
certPath: './cert.pem',
|
||||
keyPath: './key.pem',
|
||||
passphase: 'mysecretpassword',
|
||||
passphrase: 'mysecretpassword',
|
||||
}],
|
||||
}],
|
||||
},
|
||||
|
14
packages/playwright-core/types/types.d.ts
vendored
14
packages/playwright-core/types/types.d.ts
vendored
@ -1887,7 +1887,7 @@ export interface Page {
|
||||
path?: string;
|
||||
|
||||
/**
|
||||
* Script type. Use 'module' in order to load a Javascript ES6 module. See
|
||||
* Script type. Use 'module' in order to load a JavaScript ES6 module. See
|
||||
* [script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
|
||||
*/
|
||||
type?: string;
|
||||
@ -2896,7 +2896,7 @@ export interface Page {
|
||||
|
||||
/**
|
||||
* Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
|
||||
* the last redirect. If can not go back, returns `null`.
|
||||
* the last redirect. If cannot go back, returns `null`.
|
||||
*
|
||||
* Navigate to the previous page in history.
|
||||
* @param options
|
||||
@ -2926,7 +2926,7 @@ export interface Page {
|
||||
|
||||
/**
|
||||
* Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
|
||||
* the last redirect. If can not go forward, returns `null`.
|
||||
* the last redirect. If cannot go forward, returns `null`.
|
||||
*
|
||||
* Navigate to the next page in history.
|
||||
* @param options
|
||||
@ -5581,7 +5581,7 @@ export interface Frame {
|
||||
path?: string;
|
||||
|
||||
/**
|
||||
* Script type. Use 'module' in order to load a Javascript ES6 module. See
|
||||
* Script type. Use 'module' in order to load a JavaScript ES6 module. See
|
||||
* [script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
|
||||
*/
|
||||
type?: string;
|
||||
@ -19011,7 +19011,7 @@ export interface Request {
|
||||
}>>;
|
||||
|
||||
/**
|
||||
* Returns the value of the header matching the name. The name is case insensitive.
|
||||
* Returns the value of the header matching the name. The name is case-insensitive.
|
||||
* @param name Name of the header.
|
||||
*/
|
||||
headerValue(name: string): Promise<null|string>;
|
||||
@ -19272,7 +19272,7 @@ export interface Response {
|
||||
}>>;
|
||||
|
||||
/**
|
||||
* Returns the value of the header matching the name. The name is case insensitive. If multiple headers have the same
|
||||
* Returns the value of the header matching the name. The name is case-insensitive. If multiple headers have the same
|
||||
* name (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\n` separator is
|
||||
* used. If no headers are found, `null` is returned.
|
||||
* @param name Name of the header.
|
||||
@ -19280,7 +19280,7 @@ export interface Response {
|
||||
headerValue(name: string): Promise<null|string>;
|
||||
|
||||
/**
|
||||
* Returns all values of the headers matching the name, for example `set-cookie`. The name is case insensitive.
|
||||
* Returns all values of the headers matching the name, for example `set-cookie`. The name is case-insensitive.
|
||||
* @param name Name of the header.
|
||||
*/
|
||||
headerValues(name: string): Promise<Array<string>>;
|
||||
|
2
packages/playwright/types/test.d.ts
vendored
2
packages/playwright/types/test.d.ts
vendored
@ -5229,7 +5229,7 @@ export interface PlaywrightTestOptions {
|
||||
* certs: [{
|
||||
* certPath: './cert.pem',
|
||||
* keyPath: './key.pem',
|
||||
* passphase: 'mysecretpassword',
|
||||
* passphrase: 'mysecretpassword',
|
||||
* }],
|
||||
* }],
|
||||
* },
|
||||
|
Loading…
Reference in New Issue
Block a user