123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218 |
- import { coerceBooleanProperty } from '@angular/cdk/coercion';
- import { ComponentHarness, HarnessPredicate } from '@angular/cdk/testing';
- /** Harness for interacting with a mat-radio-group in tests. */
- class MatRadioGroupHarness extends ComponentHarness {
- /** The selector for the host element of a `MatRadioGroup` instance. */
- static hostSelector = '.mat-mdc-radio-group';
- _buttonClass = MatRadioButtonHarness;
- /**
- * Gets a `HarnessPredicate` that can be used to search for a radio group with specific
- * attributes.
- * @param options Options for filtering which radio group instances are considered a match.
- * @return a `HarnessPredicate` configured with the given options.
- */
- static with(options = {}) {
- return new HarnessPredicate(this, options).addOption('name', options.name, MatRadioGroupHarness._checkRadioGroupName);
- }
- /** Gets the name of the radio-group. */
- async getName() {
- const hostName = await this._getGroupNameFromHost();
- // It's not possible to always determine the "name" of a radio-group by reading
- // the attribute. This is because the radio-group does not set the "name" as an
- // element attribute if the "name" value is set through a binding.
- if (hostName !== null) {
- return hostName;
- }
- // In case we couldn't determine the "name" of a radio-group by reading the
- // "name" attribute, we try to determine the "name" of the group by going
- // through all radio buttons.
- const radioNames = await this._getNamesFromRadioButtons();
- if (!radioNames.length) {
- return null;
- }
- if (!this._checkRadioNamesInGroupEqual(radioNames)) {
- throw Error('Radio buttons in radio-group have mismatching names.');
- }
- return radioNames[0];
- }
- /** Gets the id of the radio-group. */
- async getId() {
- return (await this.host()).getProperty('id');
- }
- /** Gets the checked radio-button in a radio-group. */
- async getCheckedRadioButton() {
- for (let radioButton of await this.getRadioButtons()) {
- if (await radioButton.isChecked()) {
- return radioButton;
- }
- }
- return null;
- }
- /** Gets the checked value of the radio-group. */
- async getCheckedValue() {
- const checkedRadio = await this.getCheckedRadioButton();
- if (!checkedRadio) {
- return null;
- }
- return checkedRadio.getValue();
- }
- /**
- * Gets a list of radio buttons which are part of the radio-group.
- * @param filter Optionally filters which radio buttons are included.
- */
- async getRadioButtons(filter) {
- return this.locatorForAll(this._buttonClass.with(filter))();
- }
- /**
- * Checks a radio button in this group.
- * @param filter An optional filter to apply to the child radio buttons. The first tab matching
- * the filter will be selected.
- */
- async checkRadioButton(filter) {
- const radioButtons = await this.getRadioButtons(filter);
- if (!radioButtons.length) {
- throw Error(`Could not find radio button matching ${JSON.stringify(filter)}`);
- }
- return radioButtons[0].check();
- }
- /** Gets the name attribute of the host element. */
- async _getGroupNameFromHost() {
- return (await this.host()).getAttribute('name');
- }
- /** Gets a list of the name attributes of all child radio buttons. */
- async _getNamesFromRadioButtons() {
- const groupNames = [];
- for (let radio of await this.getRadioButtons()) {
- const radioName = await radio.getName();
- if (radioName !== null) {
- groupNames.push(radioName);
- }
- }
- return groupNames;
- }
- /** Checks if the specified radio names are all equal. */
- _checkRadioNamesInGroupEqual(radioNames) {
- let groupName = null;
- for (let radioName of radioNames) {
- if (groupName === null) {
- groupName = radioName;
- }
- else if (groupName !== radioName) {
- return false;
- }
- }
- return true;
- }
- /**
- * Checks if a radio-group harness has the given name. Throws if a radio-group with
- * matching name could be found but has mismatching radio-button names.
- */
- static async _checkRadioGroupName(harness, name) {
- // Check if there is a radio-group which has the "name" attribute set
- // to the expected group name. It's not possible to always determine
- // the "name" of a radio-group by reading the attribute. This is because
- // the radio-group does not set the "name" as an element attribute if the
- // "name" value is set through a binding.
- if ((await harness._getGroupNameFromHost()) === name) {
- return true;
- }
- // Check if there is a group with radio-buttons that all have the same
- // expected name. This implies that the group has the given name. It's
- // not possible to always determine the name of a radio-group through
- // the attribute because there is
- const radioNames = await harness._getNamesFromRadioButtons();
- if (radioNames.indexOf(name) === -1) {
- return false;
- }
- if (!harness._checkRadioNamesInGroupEqual(radioNames)) {
- throw Error(`The locator found a radio-group with name "${name}", but some ` +
- `radio-button's within the group have mismatching names, which is invalid.`);
- }
- return true;
- }
- }
- /** Harness for interacting with a mat-radio-button in tests. */
- class MatRadioButtonHarness extends ComponentHarness {
- /** The selector for the host element of a `MatRadioButton` instance. */
- static hostSelector = '.mat-mdc-radio-button';
- /**
- * Gets a `HarnessPredicate` that can be used to search for a radio button with specific
- * attributes.
- * @param options Options for filtering which radio button instances are considered a match.
- * @return a `HarnessPredicate` configured with the given options.
- */
- static with(options = {}) {
- return new HarnessPredicate(this, options)
- .addOption('label', options.label, (harness, label) => HarnessPredicate.stringMatches(harness.getLabelText(), label))
- .addOption('name', options.name, async (harness, name) => (await harness.getName()) === name)
- .addOption('checked', options.checked, async (harness, checked) => (await harness.isChecked()) == checked);
- }
- _textLabel = this.locatorFor('label');
- _clickLabel = this._textLabel;
- _input = this.locatorFor('input');
- /** Whether the radio-button is checked. */
- async isChecked() {
- const checked = (await this._input()).getProperty('checked');
- return coerceBooleanProperty(await checked);
- }
- /** Whether the radio-button is disabled. */
- async isDisabled() {
- const input = await this._input();
- const disabled = await input.getAttribute('disabled');
- if (disabled !== null) {
- return coerceBooleanProperty(disabled);
- }
- return (await input.getAttribute('aria-disabled')) === 'true';
- }
- /** Whether the radio-button is required. */
- async isRequired() {
- const required = (await this._input()).getAttribute('required');
- return coerceBooleanProperty(await required);
- }
- /** Gets the radio-button's name. */
- async getName() {
- return (await this._input()).getAttribute('name');
- }
- /** Gets the radio-button's id. */
- async getId() {
- return (await this.host()).getProperty('id');
- }
- /**
- * Gets the value of the radio-button. The radio-button value will be converted to a string.
- *
- * Note: This means that for radio-button's with an object as a value `[object Object]` is
- * intentionally returned.
- */
- async getValue() {
- return (await this._input()).getProperty('value');
- }
- /** Gets the radio-button's label text. */
- async getLabelText() {
- return (await this._textLabel()).text();
- }
- /** Focuses the radio-button. */
- async focus() {
- return (await this._input()).focus();
- }
- /** Blurs the radio-button. */
- async blur() {
- return (await this._input()).blur();
- }
- /** Whether the radio-button is focused. */
- async isFocused() {
- return (await this._input()).isFocused();
- }
- /**
- * Puts the radio-button in a checked state by clicking it if it is currently unchecked,
- * or doing nothing if it is already checked.
- */
- async check() {
- if (!(await this.isChecked())) {
- return (await this._clickLabel()).click();
- }
- }
- }
- export { MatRadioButtonHarness, MatRadioGroupHarness };
- //# sourceMappingURL=testing.mjs.map
|