1. /**
  2. * Attaches metadata to DOM elements for local utility purposes.
  3. *
  4. * @param {HTMLElement} element The DOM element to attach metadata to.
  5. * @param {object} metadata An object containing metadata properties.
  6. * @returns {void}
  7. * @throws {TypeError} If element is not an HTMLElement.
  8. */
  9. function attachMetadata(element, metadata) {
  10. if (!(element instanceof HTMLElement)) {
  11. throw new TypeError("Element must be an HTMLElement.");
  12. }
  14. if (typeof metadata !== 'object' || metadata === null) {
  15. console.warn("Metadata must be an object. Ignoring.");
  16. return;
  17. }
  19. const elementMetadata = element.dataset || {}; // Use dataset if available
  21. for (const key in metadata) {
  22. if (metadata.hasOwnProperty(key)) {
  23. const value = metadata[key];
  25. // Defensive check: Ensure value is a primitive or an object that can be stringified.
  26. if (typeof value !== 'undefined') {
  27. try {
  28. elementMetadata[key] = JSON.stringify(value); // Store metadata as string
  29. } catch (error) {
  30. console.warn(`Could not stringify metadata for key "${key}". Ignoring.`);
  31. }
  32. }
  34. }
  35. }
  37. if (element.dataset) {
  38. Object.assign(element.dataset, elementMetadata); // Merge with dataset
  39. } else {
  40. Object.assign(element, elementMetadata); //Otherwise, directly assign to element
  41. }
  43. }

Add your comment