feat(roll): roll to ToT Playwright (18-12-24) (#1627)

Author: playwrightmachine

nodejs/docs/api/class-test.mdx

@@ -1511,6 +1511,99 @@ test('example', async ({ page }) => {
 
 ---
 
+### test.step.fail {#test-step-fail}
+
+<font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.50</font><x-search>test.test.step.fail</x-search>
+
+Marks a test step as "should fail". Playwright runs this test step and ensures that it actually fails. This is useful for documentation purposes to acknowledge that some functionality is broken until it is fixed.
+
+:::note
+
+If the step exceeds the timeout, a [TimeoutError] is thrown. This indicates the step did not fail as expected.
+:::
+
+**Usage**
+
+You can declare a test step as failing, so that Playwright ensures it actually fails.
+
+```js
+import { test, expect } from '@playwright/test';
+
+test('my test', async ({ page }) => {
+  // ...
+  await test.step.fail('currently failing', async () => {
+    // ...
+  });
+});
+```
+
+**Arguments**
+- `title` [string]<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fail-option-title"/><a href="#test-step-fail-option-title" class="list-anchor">#</a>
+  
+  Step name.
+- `body` [function]\(\):[Promise]&lt;[Object]&gt;<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fail-option-body"/><a href="#test-step-fail-option-body" class="list-anchor">#</a>
+  
+  Step body.
+- `options` [Object] *(optional)*
+  - `box` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fail-option-box"/><a href="#test-step-fail-option-box" class="list-anchor">#</a>
+    
+    Whether to box the step in the report. Defaults to `false`. When the step is boxed, errors thrown from the step internals point to the step call site. See below for more details.
+  - `location` [Location] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fail-option-location"/><a href="#test-step-fail-option-location" class="list-anchor">#</a>
+    
+    Specifies a custom location for the step to be shown in test reports and trace viewer. By default, location of the [test.step()](/api/class-test.mdx#test-step) call is shown.
+  - `timeout` [number] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fail-option-timeout"/><a href="#test-step-fail-option-timeout" class="list-anchor">#</a>
+    
+    Maximum time in milliseconds for the step to finish. Defaults to `0` (no timeout).
+
+**Returns**
+- [Promise]&lt;[void]&gt;<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fail-return"/><a href="#test-step-fail-return" class="list-anchor">#</a>
+
+---
+
+### test.step.fixme {#test-step-fixme}
+
+<font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.50</font><x-search>test.test.step.fixme</x-search>
+
+Mark a test step as "fixme", with the intention to fix it. Playwright will not run the step.
+
+**Usage**
+
+You can declare a test step as failing, so that Playwright ensures it actually fails.
+
+```js
+import { test, expect } from '@playwright/test';
+
+test('my test', async ({ page }) => {
+  // ...
+  await test.step.fixme('not yet ready', async () => {
+    // ...
+  });
+});
+```
+
+**Arguments**
+- `title` [string]<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fixme-option-title"/><a href="#test-step-fixme-option-title" class="list-anchor">#</a>
+  
+  Step name.
+- `body` [function]\(\):[Promise]&lt;[Object]&gt;<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fixme-option-body"/><a href="#test-step-fixme-option-body" class="list-anchor">#</a>
+  
+  Step body.
+- `options` [Object] *(optional)*
+  - `box` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fixme-option-box"/><a href="#test-step-fixme-option-box" class="list-anchor">#</a>
+    
+    Whether to box the step in the report. Defaults to `false`. When the step is boxed, errors thrown from the step internals point to the step call site. See below for more details.
+  - `location` [Location] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fixme-option-location"/><a href="#test-step-fixme-option-location" class="list-anchor">#</a>
+    
+    Specifies a custom location for the step to be shown in test reports and trace viewer. By default, location of the [test.step()](/api/class-test.mdx#test-step) call is shown.
+  - `timeout` [number] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fixme-option-timeout"/><a href="#test-step-fixme-option-timeout" class="list-anchor">#</a>
+    
+    Maximum time in milliseconds for the step to finish. Defaults to `0` (no timeout).
+
+**Returns**
+- [Promise]&lt;[void]&gt;<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-step-fixme-return"/><a href="#test-step-fixme-return" class="list-anchor">#</a>
+
+---
+
 ### test.use {#test-use}
 
 <font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.10</font><x-search>test.test.use</x-search>