chrome-devtools-frontend/front_end/panels/issues/AffectedDescendantsWithinSelectElementView.ts

Chrome DevTools UI

// Copyright 2025 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
/* eslint-disable rulesdir/no-imperative-dom-api */

import * as i18n from '../../core/i18n/i18n.js';
import type * as Platform from '../../core/platform/platform.js';
import type * as IssuesManager from '../../models/issues_manager/issues_manager.js';

import {AffectedElementsView} from './AffectedElementsView.js';

const UIStrings = {
  /**
   *@description Noun for singular or plural number of affected descendant nodes indication in issue view.
   */
  nDescendants: '{n, plural, =1 { descendant} other { descendants}}',
  /**
   *@description Label for the disallowed node link in the issue view.
   */
  disallowedNode: 'Disallowed descendant',
} as const;
const str_ = i18n.i18n.registerUIStrings('panels/issues/AffectedDescendantsWithinSelectElementView.ts', UIStrings);
const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);

export class AffectedDescendantsWithinSelectElementView extends AffectedElementsView {
  #runningUpdatePromise: Promise<void> = Promise.resolve();

  override update(): void {
    // Ensure that doUpdate is invoked atomically by serializing the update calls
    // because it's not re-entrace safe.
    this.#runningUpdatePromise = this.#runningUpdatePromise.then(this.#doUpdate.bind(this));
  }

  protected getResourceName(count: number): Platform.UIString.LocalizedString {
    return i18nString(UIStrings.nDescendants, {n: count});
  }

  async #doUpdate(): Promise<void> {
    this.clear();
    await this.#appendDisallowedSelectDescendants(this.issue.getSelectElementAccessibilityIssues());
  }

  async #appendDisallowedSelectDescendant(
      issue: IssuesManager.SelectElementAccessibilityIssue.SelectElementAccessibilityIssue): Promise<void> {
    const row = document.createElement('tr');
    row.classList.add('affected-resource-select-element-descendant');

    const details = issue.details();
    const target = issue.model()?.target() || null;
    row.appendChild(await this.createElementCell(
        {nodeName: i18nString(UIStrings.disallowedNode), backendNodeId: details.nodeId, target}, issue.getCategory()));

    this.affectedResources.appendChild(row);
  }

  async #appendDisallowedSelectDescendants(
      issues: Iterable<IssuesManager.SelectElementAccessibilityIssue.SelectElementAccessibilityIssue>): Promise<void> {
    let count = 0;
    for (const issue of issues) {
      count++;
      await this.#appendDisallowedSelectDescendant(issue);
    }
    this.updateAffectedResourceCount(count);
  }
}