Export Locator

[jaydenseric]

It would be good to export (perhaps as just a type) the Locator class, to make it easier to cast the results in type-safe JS:

await /** @type {import("@astral/astral").Locator<HTMLAnchorElement>} */ (
  page.locator('a[href="/b"]')
).focus();

I can't figure out the most elegant way, or any way really to get things working with the current API.

For some reason this results in a deno-ts error that } is expected where the < after the ['locator'] is:

await /** @type {import("@astral/astral").Page['locator']<HTMLAnchorElement>} */ (
  page.locator
)('a[href="/b"]').focus();

[jaydenseric]

Ok, so this syntactically works:

await /** @type {typeof page.locator<HTMLAnchorElement>} */ (
  page.locator
)('a[href="/b"]').focus();

But has the deno-ts error Property 'focus' does not exist on type 'Locator<HTMLAnchorElement>'..

[lino-levan]

Is there a reason you don't want to do

await page.locator< HTMLAnchorElement>('a[href="/b"]').focus();

? I do think the locator class should be exported in case you want to pass it around places.

[jaydenseric]

This is what I finally came up with that works (at least according to TypeScript, I haven't got my test suit to progress to this point yet with Astral):

await /** @type {typeof page.locator<HTMLAnchorElement>} */ (
  page.locator
)('a[href="/b"]').evaluate((element) => {
  element.focus();
});

Locators don't have a .focus() method.

Is there a reason you don't want to do

Yes, because TypeScript syntax is unavailable in JavaScript modules in no-build projects that have type safety via TypeScript JSDoc. This type of thing would become less cumbersome if microsoft/TypeScript#27387 is ever resolved.