feat(console api): first/last/nth

packages/playwright-core/src/server/injected/consoleApi.ts

@@ -54,6 +54,9 @@ class Locator {
     self.getByTitle = (text: string | RegExp, options?: { exact?: boolean }): Locator => self.locator(getByTitleSelector(text, options));
     self.getByRole = (role: string, options: ByRoleOptions = {}): Locator => self.locator(getByRoleSelector(role, options));
     self.filter = (options?: { hasText?: string | RegExp, has?: Locator }): Locator => new Locator(injectedScript, selector, options);
+    self.first = (): Locator => self.locator('nth=0');
+    self.last = (): Locator => self.locator('nth=-1');
+    self.nth = (index: number): Locator => self.locator(`nth=${index}`);
   }
 }
 
@@ -82,6 +85,9 @@ class ConsoleAPI {
       ...new Locator(injectedScript, ''),
     };
     delete window.playwright.filter;
+    delete window.playwright.first;
+    delete window.playwright.last;
+    delete window.playwright.nth;
   }
 
   private _querySelector(selector: string, strict: boolean): (Element | undefined) {

tests/library/inspector/console-api.spec.ts

@@ -72,4 +72,26 @@ it('should support playwright.getBy*', async ({ page }) => {
   expect(await page.evaluate(`playwright.getByText('hello').element.innerHTML`)).toContain('Hello');
   expect(await page.evaluate(`playwright.getByTitle('world').element.innerHTML`)).toContain('World');
   expect(await page.evaluate(`playwright.locator('span').filter({ hasText: 'hello' }).element.innerHTML`)).toContain('Hello');
+  expect(await page.evaluate(`playwright.locator('span').first().element.innerHTML`)).toContain('Hello');
+  expect(await page.evaluate(`playwright.locator('span').last().element.innerHTML`)).toContain('World');
+  expect(await page.evaluate(`playwright.locator('span').nth(1).element.innerHTML`)).toContain('World');
+});
+
+it('expected properties on playwright object', async ({ page }) => {
+  expect(await page.evaluate(`Object.keys(playwright)`)).toEqual([
+    '$',
+    '$$',
+    'inspect',
+    'selector',
+    'generateLocator',
+    'resume',
+    'locator',
+    'getByTestId',
+    'getByAltText',
+    'getByLabel',
+    'getByPlaceholder',
+    'getByText',
+    'getByTitle',
+    'getByRole',
+  ]);
 });