docs: add note for passing world when re-use step fn

vitalets · Dec 17, 2024 · d6d7fac · d6d7fac
1 parent 8983c45
commit d6d7fac
Showing 1 changed file with 21 additions and 8 deletions.
diff --git a/docs/writing-steps/reusing-step-fn.md b/docs/writing-steps/reusing-step-fn.md
@@ -13,11 +13,24 @@ const createTodo = When('I create todo {string}', async ({ page }, text: string)
   await page.getByRole('button').click();
 });
 
-When(
-  'I create 2 todos {string} and {string}',
-  async ({ page }, text1: string, text2: string) => {
-    await createTodo({ page }, text1);
-    await createTodo({ page }, text2);
-  },
-);
-```
+When('I create 2 todos {string} and {string}', async ({ page }, text1: string, text2: string) => {
+  await createTodo({ page }, text1);
+  await createTodo({ page }, text2);
+});
+```
+
+#### Passing World
+
+For **cucumber-style steps** you should invoke step function via `.call()` to pass actual World:
+
+```js
+const createTodo = When('I create todo {string}', async function (text: string) {
+  await this.page.getByLabel('title').fill(text);
+  await this.page.getByRole('button').click();
+});
+
+When('I create 2 todos {string} and {string}', async function (text1: string, text2: string) {
+  await createTodo.call(this, text1);
+  await createTodo.call(this, text2);
+});
+```