[Feature]: Add busy option to getByRole method

🚀 Feature Request

Hey folks 👋

Small request here - I'd love to contribute a busy option to the getByRole method to target elements with aria-busy.

Example

Example JSX:

<div role="row">
  <div role="cell">Some text</div>
  <div role="cell" aria-busy={loading}>
    {loading ? <SkeletonText /> : <Text>Some text<Text>}
  </div>
<div>

Example usage in targeting the element:

this.page
  .getByRole('row')
  .getByRole('cell', {busy: false})

Motivation

We have several elements that render as skeleton blocks while loading and are then replaced with text on load finish. The goal here would be to use a locator to identify an element with a particular role but wait for aria-busy to be false.

Playwright already supports numerous aria properties here - such as expanded, pressed, selected etc. The inclusion of busy would be super helpful.

Alternatively if there's a better way to approach targeting these elements, I'm happy to hear your feedback.

Thanks ✌️

+1 for this!
Targeting on a Skeleton loader element will be much easier with this.

Dmitry Gozman (@dgozman)

Dmitry Gozman (@dgozman) just wondering, How many thumbs-up would be "popular" enough for the PR to be reopened?

Would be a really useful feature!

We would really appreciate this!

As a workaround, try the following. Please let me know whether this helps.

await page.getByRole('cell').locator(':scope[aria-busy=false]').click();

// Alternatively, you can assert that it cell becomes non-busy at some point:
await expect(page.getByRole('cell')).toHaveAttribute('aria-busy', 'false');

We have several elements that render as skeleton blocks while loading and are then replaced with text on load finish. The goal here would be to use a locator to identify an element with a particular role but wait for aria-busy to be false.

rather than wait for aria-busy=false could you just wait for the final content to be present?

more generally, can yall provide some specific usecases so we can better understand the problem trying to be solved?

We're closing all P3-collecting-feedback issues and retiring the label. #43813 explains why. This doesn't mean the request is wrong. If it still matters to you, please open a new issue against the latest Playwright version with your concrete use case and link back here.

Navigation Menu

Repository navigation

[Feature]: Add `busy` option to `getByRole` method #36233

🚀 Feature Request

Example

Motivation

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

[Feature]: Add busy option to getByRole method #36233

Description

🚀 Feature Request

Example

Motivation

Activity

tawago commented on Aug 8, 2025

tawago commented on Aug 18, 2025

dosomder commented on Aug 20, 2025

zoehneto commented on Aug 20, 2025

dgozman commented on Aug 28, 2025

dcrousso commented on Jun 15, 2026

pavelfeldman commented on Oct 31, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

[Feature]: Add `busy` option to `getByRole` method #36233