PRO-13986 feat: add actions focus and blur for selectors

Author: uid11

src/actions/blur.ts

@@ -0,0 +1,17 @@
+import {LogEventType} from '../constants/internal';
+import {log} from '../utils/log';
+
+import type {Locator} from '@playwright/test';
+
+import type {Selector} from '../types/internal';
+
+type Options = Parameters<Locator['blur']>[0];
+
+/**
+ * Blur an element.
+ */
+export const blur = async (selector: Selector, options: Options = {}): Promise<void> => {
+  log('Blur an element', {...options, selector}, LogEventType.InternalAction);
+
+  await selector.getPlaywrightLocator().blur(options);
+};

src/actions/focus.ts

@@ -0,0 +1,17 @@
+import {LogEventType} from '../constants/internal';
+import {log} from '../utils/log';
+
+import type {Locator} from '@playwright/test';
+
+import type {Selector} from '../types/internal';
+
+type Options = Parameters<Locator['focus']>[0];
+
+/**
+ * Focuses an element.
+ */
+export const focus = async (selector: Selector, options: Options = {}): Promise<void> => {
+  log('Focus an element', {...options, selector}, LogEventType.InternalAction);
+
+  await selector.getPlaywrightLocator().focus(options);
+};

src/actions/index.ts

@@ -6,13 +6,15 @@ export {
   assertSelectorInViewport,
   assertUrlMatchRoute,
 } from './asserts';
+export {blur} from './blur';
 export {clearUpload} from './clearUpload';
 export {click} from './click';
 export {deleteCookies} from './deleteCookies';
 export {dispatchEvent} from './dispatchEvent';
 export {doubleClick} from './doubleClick';
 export {drag} from './drag';
 export {dragToElement} from './dragToElement';
+export {focus} from './focus';
 export {getBrowserConsoleMessages} from './getBrowserConsoleMessages';
 export {getBrowserJsErrors} from './getBrowserJsErrors';
 export {getCookies} from './getCookies';

src/utils/test/getTestFnAndReject.ts

@@ -23,7 +23,7 @@ type Return = Readonly<{onlog: Onlog; reject: RejectTestRun; testFnWithReject: T
 
 /**
  * Get test function with execution timeout, idle timeout, reject and onlog functions,
- * by isSkipped flag, test function, runId, test execution timeout and test idle timeouts.
+ * by `isSkipped` flag, test function, runId, test execution timeout and test idle timeouts.
  * @internal
  */
 export const getTestFnAndReject = ({