Implement test helper logging if the testHelperLogging query param …

…is set

addon-test-support/@ember/test-helpers/dom/-logging.ts

@@ -1,3 +1,31 @@
+import Target from './-target';
+
+/**
+ * Logs a debug message to the console if the `testHelperLogging` query
+ * parameter is set.
+ *
+ * @private
+ * @param {string} helperName Name of the helper
+ * @param {string|Element} target The target element or selector
+ */
+export function log(helperName: string, target: Target, ...args: any[]) {
+  if (loggingEnabled()) {
+    // eslint-disable-next-line no-console
+    console.log(`${helperName}(${[elementToString(target), ...args.filter(Boolean)].join(', ')})`);
+  }
+}
+
+/**
+ * Returns whether the test helper logging is enabled or not via the
+ * `testHelperLogging` query parameter.
+ *
+ * @private
+ * @returns {boolean} true if enabled
+ */
+function loggingEnabled(): boolean {
+  return typeof location !== 'undefined' && location.search.indexOf('testHelperLogging') !== -1;
+}
+
 /**
  * This generates a human-readable description to a DOM element.
  *

addon-test-support/@ember/test-helpers/dom/blur.ts

@@ -4,6 +4,7 @@ import settled from '../settled';
 import isFocusable from './-is-focusable';
 import { nextTickPromise } from '../-utils';
 import Target from './-target';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 /**
   @private
@@ -51,6 +52,8 @@ export function __blur__(element: HTMLElement | SVGElement): void {
   blur('input');
 */
 export default function blur(target: Target = document.activeElement!): Promise<void> {
+  log('blur', target);
+
   return nextTickPromise().then(() => {
     let element = getElement(target);
     if (!element) {

addon-test-support/@ember/test-helpers/dom/click.ts

@@ -6,6 +6,7 @@ import isFocusable from './-is-focusable';
 import { nextTickPromise } from '../-utils';
 import isFormControl from './-is-form-control';
 import Target from './-target';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 /**
   @private
@@ -69,6 +70,8 @@ export function __click__(element: Element | Document, options: MouseEventInit):
   click('button', { shiftKey: true });
 */
 export default function click(target: Target, options: MouseEventInit = {}): Promise<void> {
+  log('click', target);
+
   return nextTickPromise().then(() => {
     if (!target) {
       throw new Error('Must pass an element or selector to `click`.');

addon-test-support/@ember/test-helpers/dom/double-click.ts

@@ -5,6 +5,7 @@ import settled from '../settled';
 import isFocusable from './-is-focusable';
 import { nextTickPromise } from '../-utils';
 import Target from './-target';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 /**
   @private
@@ -80,6 +81,8 @@ export function __doubleClick__(element: Element | Document, options: MouseEvent
   doubleClick('button', { shiftKey: true });
 */
 export default function doubleClick(target: Target, options: MouseEventInit = {}): Promise<void> {
+  log('doubleClick', target);
+
   return nextTickPromise().then(() => {
     if (!target) {
       throw new Error('Must pass an element or selector to `doubleClick`.');

addon-test-support/@ember/test-helpers/dom/fill-in.ts

@@ -5,6 +5,7 @@ import settled from '../settled';
 import fireEvent from './fire-event';
 import { nextTickPromise } from '../-utils';
 import Target from './-target';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 /**
   Fill the provided text into the `value` property (or set `.innerHTML` when
@@ -24,6 +25,8 @@ import Target from './-target';
   fillIn('input', 'hello world');
 */
 export default function fillIn(target: Target, text: string): Promise<void> {
+  log('fillIn', target, text);
+
   return nextTickPromise().then(() => {
     if (!target) {
       throw new Error('Must pass an element or selector to `fillIn`.');

addon-test-support/@ember/test-helpers/dom/focus.ts

@@ -4,6 +4,7 @@ import settled from '../settled';
 import isFocusable from './-is-focusable';
 import { nextTickPromise } from '../-utils';
 import Target from './-target';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 /**
   @private
@@ -54,6 +55,8 @@ export function __focus__(element: HTMLElement | SVGElement): void {
   focus('input');
 */
 export default function focus(target: Target): Promise<void> {
+  log('focus', target);
+
   return nextTickPromise().then(() => {
     if (!target) {
       throw new Error('Must pass an element or selector to `focus`.');

addon-test-support/@ember/test-helpers/dom/tap.ts

@@ -4,6 +4,7 @@ import { __click__ } from './click';
 import settled from '../settled';
 import { nextTickPromise } from '../-utils';
 import Target from './-target';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 /**
   Taps on the specified target.
@@ -48,6 +49,8 @@ import Target from './-target';
   tap('button');
 */
 export default function tap(target: Target, options: object = {}): Promise<void> {
+  log('tap', target);
+
   return nextTickPromise().then(() => {
     if (!target) {
       throw new Error('Must pass an element or selector to `tap`.');

addon-test-support/@ember/test-helpers/dom/trigger-event.ts

@@ -3,6 +3,7 @@ import fireEvent from './fire-event';
 import settled from '../settled';
 import { nextTickPromise } from '../-utils';
 import Target from './-target';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 /**
  * Triggers an event on the specified target.
@@ -52,6 +53,8 @@ export default function triggerEvent(
   eventType: string,
   options?: object
 ): Promise<void> {
+  log('triggerEvent', target, eventType);
+
   return nextTickPromise().then(() => {
     if (!target) {
       throw new Error('Must pass an element or selector to `triggerEvent`.');

addon-test-support/@ember/test-helpers/dom/trigger-key-event.ts

@@ -5,6 +5,7 @@ import settled from '../settled';
 import { KEYBOARD_EVENT_TYPES, KeyboardEventType, isKeyboardEventType } from './fire-event';
 import { nextTickPromise, isNumeric } from '../-utils';
 import Target from './-target';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 export interface KeyModifiers {
   ctrlKey?: boolean;
@@ -183,6 +184,8 @@ export default function triggerKeyEvent(
   key: number | string,
   modifiers: KeyModifiers = DEFAULT_MODIFIERS
 ): Promise<void> {
+  log('triggerKeyEvent', target, eventType, key);
+
   return nextTickPromise().then(() => {
     if (!target) {
       throw new Error('Must pass an element or selector to `triggerKeyEvent`.');

addon-test-support/@ember/test-helpers/dom/type-in.ts

@@ -8,6 +8,7 @@ import { Promise } from 'rsvp';
 import fireEvent from './fire-event';
 import Target from './-target';
 import { __triggerKeyEvent__ } from './trigger-key-event';
+import { log } from '@ember/test-helpers/dom/-logging';
 
 export interface Options {
   delay?: number;
@@ -38,6 +39,8 @@ export interface Options {
  * typeIn('hello world');
  */
 export default function typeIn(target: Target, text: string, options: Options = {}): Promise<void> {
+  log('typeIn', target, text);
+
   return nextTickPromise().then(() => {
     if (!target) {
       throw new Error('Must pass an element or selector to `typeIn`.');