open-wc/packages/testing-helpers/stringFixture.js

import { fixtureWrapper } from './fixtureWrapper.js';
import { elementUpdated } from './elementUpdated.js';

/**
 * Setups an element synchronously from the provided string template and puts it in the DOM.
 * Allows to specify properties via an object or a function taking the element as an argument.
 *
 * @template {Element} T - Is an element or a node
 * @param {string} template
 * @returns {T}
 */
export function stringFixtureSync(template) {
  const wrapper = fixtureWrapper();
  wrapper.innerHTML = template;
  return /** @type {T} */ (wrapper.children[0]);
}

/**
 * Setups an element asynchronously from the provided string template and puts it in the DOM.
 * Allows to specify properties via an object or a function taking the element as an argument.
 *
 * @template {Element} T - Is an element or a node
 * @param {string} template
 * @returns {Promise<T>}
 */
export async function stringFixture(template) {
  const el = stringFixtureSync(template);
  await elementUpdated(el);
  return el;
}