mirror of
https://github.com/apache/superset.git
synced 2026-04-13 21:24:28 +00:00
5040db859c
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
110 lines
3.0 KiB
TypeScript
110 lines
3.0 KiB
TypeScript
/**
|
|
* Licensed to the Apache Software Foundation (ASF) under one
|
|
* or more contributor license agreements. See the NOTICE file
|
|
* distributed with this work for additional information
|
|
* regarding copyright ownership. The ASF licenses this file
|
|
* to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance
|
|
* with the License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing,
|
|
* software distributed under the License is distributed on an
|
|
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
* KIND, either express or implied. See the License for the
|
|
* specific language governing permissions and limitations
|
|
* under the License.
|
|
*/
|
|
|
|
import { Locator, Page } from '@playwright/test';
|
|
|
|
/**
|
|
* Playwright helper for interacting with HTML {@link HTMLTextAreaElement | `<textarea>`} elements.
|
|
*
|
|
* This component wraps a Playwright {@link Locator} and provides convenience methods for
|
|
* filling, clearing, and reading the value of a textarea without having to work with
|
|
* locators directly.
|
|
*
|
|
* Typical usage:
|
|
* ```ts
|
|
* const textarea = new Textarea(page, 'textarea[name="description"]');
|
|
* await textarea.fill('Some multi-line text');
|
|
* const value = await textarea.getValue();
|
|
* ```
|
|
*
|
|
* You can also construct an instance from the `name` attribute:
|
|
* ```ts
|
|
* const textarea = Textarea.fromName(page, 'description');
|
|
* await textarea.clear();
|
|
* ```
|
|
*/
|
|
export class Textarea {
|
|
readonly page: Page;
|
|
private readonly locator: Locator;
|
|
|
|
constructor(page: Page, selector: string);
|
|
constructor(page: Page, locator: Locator);
|
|
constructor(page: Page, selectorOrLocator: string | Locator) {
|
|
this.page = page;
|
|
if (typeof selectorOrLocator === 'string') {
|
|
this.locator = page.locator(selectorOrLocator);
|
|
} else {
|
|
this.locator = selectorOrLocator;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Creates a Textarea from a name attribute
|
|
* @param page - The Playwright page
|
|
* @param name - The name attribute value
|
|
*/
|
|
static fromName(page: Page, name: string): Textarea {
|
|
const locator = page.locator(`textarea[name="${name}"]`);
|
|
return new Textarea(page, locator);
|
|
}
|
|
|
|
/**
|
|
* Gets the textarea element locator
|
|
*/
|
|
get element(): Locator {
|
|
return this.locator;
|
|
}
|
|
|
|
/**
|
|
* Fills the textarea with text (clears existing content)
|
|
* @param text - The text to fill
|
|
*/
|
|
async fill(text: string): Promise<void> {
|
|
await this.locator.fill(text);
|
|
}
|
|
|
|
/**
|
|
* Clears the textarea content
|
|
*/
|
|
async clear(): Promise<void> {
|
|
await this.locator.clear();
|
|
}
|
|
|
|
/**
|
|
* Gets the current value of the textarea
|
|
*/
|
|
async getValue(): Promise<string> {
|
|
return this.locator.inputValue();
|
|
}
|
|
|
|
/**
|
|
* Checks if the textarea is visible
|
|
*/
|
|
async isVisible(): Promise<boolean> {
|
|
return this.locator.isVisible();
|
|
}
|
|
|
|
/**
|
|
* Checks if the textarea is enabled
|
|
*/
|
|
async isEnabled(): Promise<boolean> {
|
|
return this.locator.isEnabled();
|
|
}
|
|
}
|