diff --git a/lib/utils/wrap.js b/lib/utils/wrap.js index 0fb006c63d..ece21a4e1b 100644 --- a/lib/utils/wrap.js +++ b/lib/utils/wrap.js @@ -8,12 +8,16 @@ Code distributed by Google as part of the polymer project is also subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt */ -// Node wrapper to ensure ShadowDOM safe operation regardless of polyfill -// presence or mode. Note that with the introduction of `ShadyDOM.noPatch`, -// a node wrapper must be used to access ShadowDOM API. -// This is similar to using `Polymer.dom` but relies exclusively -// on the presence of the ShadyDOM polyfill rather than requiring the loading -// of legacy (Polymer.dom) API. +/* eslint-disable valid-jsdoc */ +/** + * Node wrapper to ensure ShadowDOM safe operation regardless of polyfill + * presence or mode. Note that with the introduction of `ShadyDOM.noPatch`, + * a node wrapper must be used to access ShadowDOM API. + * This is similar to using `Polymer.dom` but relies exclusively + * on the presence of the ShadyDOM polyfill rather than requiring the loading + * of legacy (Polymer.dom) API. + * @type {function(Node):Node} + */ export const wrap = (window['ShadyDOM'] && window['ShadyDOM']['noPatch'] && window['ShadyDOM']['wrap']) ? window['ShadyDOM']['wrap'] : (n) => n;