Update package version to 1.0.8, implement 'wait' action in step executor, and modify examples to utilize the new wait functionality. Enhance integration tests to validate wait behavior with both 'value' and 'wait' properties.

lablnet · lablnet · commit b75ee138d643 · 2025-12-19T07:32:18.000+05:00
diff --git a/examples/advanced-usage.js b/examples/advanced-usage.js
@@ -10,9 +10,8 @@ async function advancedExample() {
             },
             {
                 id: 'wait_for_page',
-                action: 'scroll',
-                value: '100',
-                wait: 3000
+                action: 'wait',
+                value: '3000'
             }
         ],
         perPageSteps: [{
diff --git a/examples/advanced-usage.ts b/examples/advanced-usage.ts
@@ -12,9 +12,8 @@ async function advancedExample() {
         },
         {
           id: 'wait_for_page',
-          action: 'scroll',
-          value: '100',
-          wait: 3000
+          action: 'wait',
+          value: '3000'
         }
       ],
       perPageSteps: [
diff --git a/examples/basic-usage.js b/examples/basic-usage.js
@@ -10,9 +10,8 @@ async function basicExample() {
             },
             {
                 id: 'wait_for_page',
-                action: 'scroll',
-                value: '100',
-                wait: 2000
+                action: 'wait',
+                value: '2000'
             },
             {
                 id: 'get_title',
@@ -22,6 +21,11 @@ async function basicExample() {
                 key: 'title',
                 data_type: 'text'
             },
+            {
+                id: 'wait_after_title',
+                action: 'wait',
+                wait: 1000
+            },
             {
                 id: 'get_description',
                 action: 'data',
diff --git a/examples/basic-usage.ts b/examples/basic-usage.ts
@@ -12,22 +12,25 @@ async function basicExample() {
          },
          {
            id: 'wait_for_page',
-           action: 'scroll',
-           value: '100',
-           wait: 2000
+           action: 'wait',
+           value: '2000'
+         },
+         {
+           id: 'get_title',
+           action: 'data',
+           object_type: 'tag',
+           object: 'h1',
+           key: 'title',
+           data_type: 'text'
          },
-        {
-          id: 'get_title',
-          action: 'data',
-          object_type: 'tag',
-          object: 'h1',
-          key: 'title',
-          data_type: 'text'
-        },
         {
           id: "reload",
           action: 'reload',
-          value: 'load',
+          value: 'load'
+        },
+        {
+          id: 'wait_after_reload',
+          action: 'wait',
           wait: 2000
         },
         {
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "stepwright",
-    "version": "1.0.7",
+    "version": "1.0.8",
     "description": "A powerful web scraping library built with Playwright",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
diff --git a/src/step-executor.ts b/src/step-executor.ts
@@ -394,6 +394,25 @@ export async function executeStep(
       await page.evaluate((y: number) => window.scrollBy(0, y), offset);
       break;
     }
+    case 'wait': {
+      // Wait for a specified duration in milliseconds
+      // Duration can be provided via step.value (as string) or step.wait (as number)
+      let duration = 0;
+      if (step.value) {
+        duration = parseInt(step.value, 10);
+      } else if (step.wait) {
+        duration = step.wait;
+      } else {
+        console.log(`   ⚠️  Wait step ${step.id} requires 'value' (duration in ms) or 'wait' property`);
+        break;
+      }
+      
+      if (duration > 0) {
+        console.log(`   ⏳ Waiting ${duration}ms...`);
+        await page.waitForTimeout(duration);
+      }
+      break;
+    }
     case 'reload': {
       // Reload the current page
       try {
diff --git a/src/types.ts b/src/types.ts
@@ -11,7 +11,7 @@ export interface BaseStep {
   description?: string;
   object_type?: SelectorType;
   object?: string;
-  action: 'navigate' | 'input' | 'click' | 'data' | 'scroll' | 'reload' | 'eventBaseDownload' | 'foreach' | 'open' | 'savePDF' | 'printToPDF' | 'downloadPDF' | 'downloadFile';
+  action: 'navigate' | 'input' | 'click' | 'data' | 'scroll' | 'reload' | 'eventBaseDownload' | 'foreach' | 'open' | 'savePDF' | 'printToPDF' | 'downloadPDF' | 'downloadFile' | 'wait';
   value?: string;
   key?: string; // property key when collecting data
   data_type?: DataType;
diff --git a/test/integration.test.ts b/test/integration.test.ts
@@ -330,5 +330,131 @@ describe('Integration Tests', () => {
       expect(results[0].title).toBe('StepWright Test Page');
       expect(results[0].page_title).toBe('StepWright Test Page');
     });
+
+    it('should handle wait action with value property', async () => {
+      const templates :TabTemplate[] = [
+        {
+          tab: 'wait_test',
+          steps: [
+            {
+              id: 'navigate',
+              action: 'navigate',
+              value: testPageUrl
+            },
+            {
+              id: 'wait_before_extraction',
+              action: 'wait',
+              value: '500'
+            },
+            {
+              id: 'get_title',
+              action: 'data',
+              object_type: 'id',
+              object: 'main-title',
+              key: 'title',
+              data_type: 'text'
+            }
+          ]
+        }
+      ];
+
+      const startTime = Date.now();
+      const results = await runScraper(templates);
+      const endTime = Date.now();
+      const duration = endTime - startTime;
+
+      expect(results).toHaveLength(1);
+      expect(results[0].title).toBe('StepWright Test Page');
+      // Verify that wait actually occurred (allowing some margin for test execution)
+      expect(duration).toBeGreaterThanOrEqual(400);
+    });
+
+    it('should handle wait action with wait property', async () => {
+      const templates :TabTemplate[] = [
+        {
+          tab: 'wait_test_wait_prop',
+          steps: [
+            {
+              id: 'navigate',
+              action: 'navigate',
+              value: testPageUrl
+            },
+            {
+              id: 'wait_before_extraction',
+              action: 'wait',
+              wait: 300
+            },
+            {
+              id: 'get_title',
+              action: 'data',
+              object_type: 'id',
+              object: 'main-title',
+              key: 'title',
+              data_type: 'text'
+            }
+          ]
+        }
+      ];
+
+      const startTime = Date.now();
+      const results = await runScraper(templates);
+      const endTime = Date.now();
+      const duration = endTime - startTime;
+
+      expect(results).toHaveLength(1);
+      expect(results[0].title).toBe('StepWright Test Page');
+      // Verify that wait actually occurred (allowing some margin for test execution)
+      expect(duration).toBeGreaterThanOrEqual(200);
+    });
+
+    it('should handle wait action in sequence with other actions', async () => {
+      const templates :TabTemplate[] = [
+        {
+          tab: 'wait_sequence_test',
+          steps: [
+            {
+              id: 'navigate',
+              action: 'navigate',
+              value: testPageUrl
+            },
+            {
+              id: 'wait_after_navigate',
+              action: 'wait',
+              value: '200'
+            },
+            {
+              id: 'fill_search',
+              action: 'input',
+              object_type: 'id',
+              object: 'search-box',
+              value: 'test search'
+            },
+            {
+              id: 'wait_after_input',
+              action: 'wait',
+              value: '200'
+            },
+            {
+              id: 'get_search_value',
+              action: 'data',
+              object_type: 'id',
+              object: 'search-box',
+              key: 'search_value',
+              data_type: 'value'
+            }
+          ]
+        }
+      ];
+
+      const startTime = Date.now();
+      const results = await runScraper(templates);
+      const endTime = Date.now();
+      const duration = endTime - startTime;
+
+      expect(results).toHaveLength(1);
+      expect(results[0].search_value).toBe('test search');
+      // Verify that waits occurred (allowing some margin for test execution)
+      expect(duration).toBeGreaterThanOrEqual(300);
+    });
   });
 });

Original file line number	Diff line number	Diff line change
`@@ -10,9 +10,8 @@ async function advancedExample() {`
`10`	`10`	`},`
`11`	`11`	`{`
`12`	`12`	`id: 'wait_for_page',`
`13`		`- action: 'scroll',`
`14`		`- value: '100',`
`15`		`- wait: 3000`
	`13`	`+ action: 'wait',`
	`14`	`+ value: '3000'`
`16`	`15`	`}`
`17`	`16`	`],`
`18`	`17`	`perPageSteps: [{`
Original file line number	Diff line number	Diff line change
`@@ -12,9 +12,8 @@ async function advancedExample() {`
`12`	`12`	`},`
`13`	`13`	`{`
`14`	`14`	`id: 'wait_for_page',`
`15`		`- action: 'scroll',`
`16`		`- value: '100',`
`17`		`- wait: 3000`
	`15`	`+ action: 'wait',`
	`16`	`+ value: '3000'`
`18`	`17`	`}`
`19`	`18`	`],`
`20`	`19`	`perPageSteps: [`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "stepwright",`
`3`		`- "version": "1.0.7",`
	`3`	`+ "version": "1.0.8",`
`4`	`4`	`"description": "A powerful web scraping library built with Playwright",`
`5`	`5`	`"main": "dist/index.js",`
`6`	`6`	`"types": "dist/index.d.ts",`