@badisi/wdio-harness 4.2.1 → 4.3.0

package/README.md

@@ -11,14 +11,14 @@
         <img src="https://img.shields.io/npm/v/@badisi/wdio-harness.svg?color=blue&logo=npm" alt="npm version" /></a>
     <a href="https://npmcharts.com/compare/@badisi/wdio-harness?minimal=true">
         <img src="https://img.shields.io/npm/dw/@badisi/wdio-harness.svg?color=7986CB&logo=npm" alt="npm donwloads" /></a>
-    <a href="https://github.com/badisi/wdio-harness/blob/main/LICENSE">
+    <a href="https://github.com/Badisi/wdio-harness/blob/main/LICENSE">
         <img src="https://img.shields.io/npm/l/@badisi/wdio-harness.svg?color=ff69b4" alt="license" /></a>
 </p>
 
 <p align="center">
     <a href="https://github.com/Badisi/wdio-harness/actions/workflows/ci_tests.yml">
-        <img src="https://github.com/Badisi/wdio-harness/actions/workflows/ci_tests.yml/badge.svg" alt="build status" /></a>
-    <a href="https://github.com/badisi/wdio-harness/blob/main/CONTRIBUTING.md#-submitting-a-pull-request-pr">
+        <img src="https://img.shields.io/github/actions/workflow/status/badisi/wdio-harness/ci_tests.yml?logo=github" alt="build status" /></a>
+    <a href="https://github.com/Badisi/wdio-harness/blob/main/CONTRIBUTING.md#-submitting-a-pull-request-pr">
         <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome" /></a>
 </p>
 
@@ -57,6 +57,7 @@ __Methods__
 __Example__
 
 ```ts
+import '@angular/compiler'; // required since Angular v21
 import { MatDatepickerInputHarness } from '@angular/material/datepicker/testing';
 import { getHarness } from '@badisi/wdio-harness';
 
@@ -103,7 +104,7 @@ Please read and follow the [Code of Conduct][codeofconduct] and help me keep thi
 
 
 
-[developer]: https://github.com/badisi/wdio-harness/blob/main/DEVELOPER.md
-[contributing]: https://github.com/badisi/wdio-harness/blob/main/CONTRIBUTING.md
-[codeofconduct]: https://github.com/badisi/wdio-harness/blob/main/CODE_OF_CONDUCT.md
-[examples]: https://github.com/badisi/wdio-harness/blob/main/projects/tests-e2e/harness.e2e.ts
+[developer]: https://github.com/Badisi/wdio-harness/blob/main/DEVELOPER.md
+[contributing]: https://github.com/Badisi/wdio-harness/blob/main/CONTRIBUTING.md
+[codeofconduct]: https://github.com/Badisi/wdio-harness/blob/main/CODE_OF_CONDUCT.md
+[examples]: https://github.com/Badisi/wdio-harness/blob/main/projects/tests-e2e/harness.e2e.ts

package/WebdriverIOHarnessEnvironment.d.ts

@@ -1,4 +1,4 @@
-import { ComponentHarness, ComponentHarnessConstructor, HarnessEnvironment } from '@angular/cdk/testing';
+import { type ComponentHarness, type ComponentHarnessConstructor, HarnessEnvironment } from '@angular/cdk/testing';
 import { WebdriverIOTestElement } from './WebdriverIOTestElement.js';
 /**
  * A `HarnessEnvironment` implementation for WebdriverIO.

package/WebdriverIOHarnessEnvironment.js

@@ -1,7 +1,7 @@
 import { HarnessEnvironment } from '@angular/cdk/testing';
+import colors from '@colors/colors/safe.js';
 import logger from '@wdio/logger';
 import { WebdriverIOTestElement } from './WebdriverIOTestElement.js';
-import colors from '@colors/colors/safe.js';
 const { magenta, green } = colors;
 /** Registers the environment logger. */
 const log = logger('wdio-harness');

package/WebdriverIOTestElement.d.ts

@@ -1,4 +1,4 @@
-import { ElementDimensions, EventData, ModifierKeys, TestElement, TestKey, TextOptions } from '@angular/cdk/testing';
+import { type ElementDimensions, type EventData, type ModifierKeys, type TestElement, TestKey, type TextOptions } from '@angular/cdk/testing';
 /** Module augmentation to expose the host element as a public api */
 declare module '@angular/cdk/testing' {
     interface ComponentHarness {
@@ -62,6 +62,11 @@ export declare class WebdriverIOTestElement implements TestElement {
     sendKeys(modifiers: ModifierKeys, ...keys: (string | TestKey)[]): Promise<void>;
     /** Gets the text from the element. */
     text(options?: TextOptions): Promise<string>;
+    /**
+     * Sets the value of a `contenteditable` element.
+     * @param value Value to be set on the element.
+    */
+    setContenteditableValue(value: string): Promise<void>;
     /** Gets the value for the given attribute from the element. */
     getAttribute(name: string): Promise<string | null>;
     /** Checks whether the element has the given class. */

package/WebdriverIOTestElement.js

@@ -1,7 +1,7 @@
-import { TestKey, ComponentHarness } from '@angular/cdk/testing';
+import { ComponentHarness, TestKey } from '@angular/cdk/testing';
+import colors from '@colors/colors/safe.js';
 import { browser } from '@wdio/globals';
 import logger from '@wdio/logger';
-import colors from '@colors/colors/safe.js';
 const { magenta, green } = colors;
 var Button;
 (function (Button) {
@@ -160,6 +160,19 @@ export class WebdriverIOTestElement {
         // We don't go through WebdriverIO's `getText`, because it excludes text from hidden elements.
         return browser.executeScript(`return (arguments[0].textContent ?? '').trim()`, [this.hostElement]);
     }
+    /**
+     * Sets the value of a `contenteditable` element.
+     * @param value Value to be set on the element.
+    */
+    async setContenteditableValue(value) {
+        const contenteditableAttr = await this.getAttribute('contenteditable');
+        if (contenteditableAttr !== '' &&
+            contenteditableAttr !== 'true' &&
+            contenteditableAttr !== 'plaintext-only') {
+            throw new Error('setContenteditableValue can only be called on a `contenteditable` element.');
+        }
+        return browser.executeScript('arguments[0].textContent = arguments[1];', [this.hostElement, value]);
+    }
     /** Gets the value for the given attribute from the element. */
     async getAttribute(name) {
         this.logAction('GET_ATTRIBUTE', name);

package/index.d.ts

@@ -1,4 +1,4 @@
-import { ComponentHarness, HarnessQuery } from '@angular/cdk/testing';
+import type { ComponentHarness, HarnessQuery } from '@angular/cdk/testing';
 import { WebdriverIOHarnessEnvironment } from './WebdriverIOHarnessEnvironment.js';
 /**
  * Searches for all instances of the component corresponding to the given harness type under the

package/index.js

@@ -1,4 +1,4 @@
-import { browser, $ } from '@wdio/globals';
+import { $, browser } from '@wdio/globals';
 import { WebdriverIOHarnessEnvironment } from './WebdriverIOHarnessEnvironment.js';
 /**
  * Searches for all instances of the component corresponding to the given harness type under the

package/package.json

@@ -1,8 +1,8 @@
 {
     "name": "@badisi/wdio-harness",
-    "version": "4.2.1",
+    "version": "4.3.0",
     "description": "WebdriverIO support for Angular component test harnesses.",
-    "homepage": "https://github.com/badisi/wdio-harness",
+    "homepage": "https://github.com/Badisi/wdio-harness",
     "license": "MIT",
     "author": {
         "name": "Badisi"
@@ -20,7 +20,7 @@
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/badisi/wdio-harness.git"
+        "url": "https://github.com/Badisi/wdio-harness"
     },
     "keywords": [
         "angular",
@@ -39,7 +39,7 @@
         "node": "^16.14.0 || >=18.10.0"
     },
     "peerDependencies": {
-        "@angular/cdk": ">= 13 < 21",
+        "@angular/cdk": ">= 13 < 22",
         "@wdio/logger": ">= 9 < 10",
         "webdriverio": ">= 9 < 10"
     },