Nessuna descrizione

deprecated.js 7.6KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191
  1. this["wp"] = this["wp"] || {}; this["wp"]["deprecated"] =
  2. /******/ (function(modules) { // webpackBootstrap
  3. /******/ // The module cache
  4. /******/ var installedModules = {};
  5. /******/
  6. /******/ // The require function
  7. /******/ function __webpack_require__(moduleId) {
  8. /******/
  9. /******/ // Check if module is in cache
  10. /******/ if(installedModules[moduleId]) {
  11. /******/ return installedModules[moduleId].exports;
  12. /******/ }
  13. /******/ // Create a new module (and put it into the cache)
  14. /******/ var module = installedModules[moduleId] = {
  15. /******/ i: moduleId,
  16. /******/ l: false,
  17. /******/ exports: {}
  18. /******/ };
  19. /******/
  20. /******/ // Execute the module function
  21. /******/ modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
  22. /******/
  23. /******/ // Flag the module as loaded
  24. /******/ module.l = true;
  25. /******/
  26. /******/ // Return the exports of the module
  27. /******/ return module.exports;
  28. /******/ }
  29. /******/
  30. /******/
  31. /******/ // expose the modules object (__webpack_modules__)
  32. /******/ __webpack_require__.m = modules;
  33. /******/
  34. /******/ // expose the module cache
  35. /******/ __webpack_require__.c = installedModules;
  36. /******/
  37. /******/ // define getter function for harmony exports
  38. /******/ __webpack_require__.d = function(exports, name, getter) {
  39. /******/ if(!__webpack_require__.o(exports, name)) {
  40. /******/ Object.defineProperty(exports, name, { enumerable: true, get: getter });
  41. /******/ }
  42. /******/ };
  43. /******/
  44. /******/ // define __esModule on exports
  45. /******/ __webpack_require__.r = function(exports) {
  46. /******/ if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
  47. /******/ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
  48. /******/ }
  49. /******/ Object.defineProperty(exports, '__esModule', { value: true });
  50. /******/ };
  51. /******/
  52. /******/ // create a fake namespace object
  53. /******/ // mode & 1: value is a module id, require it
  54. /******/ // mode & 2: merge all properties of value into the ns
  55. /******/ // mode & 4: return value when already ns object
  56. /******/ // mode & 8|1: behave like require
  57. /******/ __webpack_require__.t = function(value, mode) {
  58. /******/ if(mode & 1) value = __webpack_require__(value);
  59. /******/ if(mode & 8) return value;
  60. /******/ if((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;
  61. /******/ var ns = Object.create(null);
  62. /******/ __webpack_require__.r(ns);
  63. /******/ Object.defineProperty(ns, 'default', { enumerable: true, value: value });
  64. /******/ if(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key));
  65. /******/ return ns;
  66. /******/ };
  67. /******/
  68. /******/ // getDefaultExport function for compatibility with non-harmony modules
  69. /******/ __webpack_require__.n = function(module) {
  70. /******/ var getter = module && module.__esModule ?
  71. /******/ function getDefault() { return module['default']; } :
  72. /******/ function getModuleExports() { return module; };
  73. /******/ __webpack_require__.d(getter, 'a', getter);
  74. /******/ return getter;
  75. /******/ };
  76. /******/
  77. /******/ // Object.prototype.hasOwnProperty.call
  78. /******/ __webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
  79. /******/
  80. /******/ // __webpack_public_path__
  81. /******/ __webpack_require__.p = "";
  82. /******/
  83. /******/
  84. /******/ // Load entry module and return exports
  85. /******/ return __webpack_require__(__webpack_require__.s = "+BeG");
  86. /******/ })
  87. /************************************************************************/
  88. /******/ ({
  89. /***/ "+BeG":
  90. /***/ (function(module, __webpack_exports__, __webpack_require__) {
  91. "use strict";
  92. __webpack_require__.r(__webpack_exports__);
  93. /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "logged", function() { return logged; });
  94. /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "default", function() { return deprecated; });
  95. /* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("g56x");
  96. /* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__);
  97. /**
  98. * WordPress dependencies
  99. */
  100. /**
  101. * Object map tracking messages which have been logged, for use in ensuring a
  102. * message is only logged once.
  103. *
  104. * @type {Record<string, true | undefined>}
  105. */
  106. const logged = Object.create(null);
  107. /**
  108. * Logs a message to notify developers about a deprecated feature.
  109. *
  110. * @param {string} feature Name of the deprecated feature.
  111. * @param {Object} [options] Personalisation options
  112. * @param {string} [options.since] Version in which the feature was deprecated.
  113. * @param {string} [options.version] Version in which the feature will be removed.
  114. * @param {string} [options.alternative] Feature to use instead
  115. * @param {string} [options.plugin] Plugin name if it's a plugin feature
  116. * @param {string} [options.link] Link to documentation
  117. * @param {string} [options.hint] Additional message to help transition away from the deprecated feature.
  118. *
  119. * @example
  120. * ```js
  121. * import deprecated from '@wordpress/deprecated';
  122. *
  123. * deprecated( 'Eating meat', {
  124. * since: '2019.01.01'
  125. * version: '2020.01.01',
  126. * alternative: 'vegetables',
  127. * plugin: 'the earth',
  128. * hint: 'You may find it beneficial to transition gradually.',
  129. * } );
  130. *
  131. * // Logs: 'Eating meat is deprecated since version 2019.01.01 and will be removed from the earth in version 2020.01.01. Please use vegetables instead. Note: You may find it beneficial to transition gradually.'
  132. * ```
  133. */
  134. function deprecated(feature, options = {}) {
  135. const {
  136. since,
  137. version,
  138. alternative,
  139. plugin,
  140. link,
  141. hint
  142. } = options;
  143. const pluginMessage = plugin ? ` from ${plugin}` : '';
  144. const sinceMessage = since ? ` since version ${since}` : '';
  145. const versionMessage = version ? ` and will be removed${pluginMessage} in version ${version}` : '';
  146. const useInsteadMessage = alternative ? ` Please use ${alternative} instead.` : '';
  147. const linkMessage = link ? ` See: ${link}` : '';
  148. const hintMessage = hint ? ` Note: ${hint}` : '';
  149. const message = `${feature} is deprecated${sinceMessage}${versionMessage}.${useInsteadMessage}${linkMessage}${hintMessage}`; // Skip if already logged.
  150. if (message in logged) {
  151. return;
  152. }
  153. /**
  154. * Fires whenever a deprecated feature is encountered
  155. *
  156. * @param {string} feature Name of the deprecated feature.
  157. * @param {?Object} options Personalisation options
  158. * @param {string} options.since Version in which the feature was deprecated.
  159. * @param {?string} options.version Version in which the feature will be removed.
  160. * @param {?string} options.alternative Feature to use instead
  161. * @param {?string} options.plugin Plugin name if it's a plugin feature
  162. * @param {?string} options.link Link to documentation
  163. * @param {?string} options.hint Additional message to help transition away from the deprecated feature.
  164. * @param {?string} message Message sent to console.warn
  165. */
  166. Object(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__["doAction"])('deprecated', feature, options, message); // eslint-disable-next-line no-console
  167. console.warn(message);
  168. logged[message] = true;
  169. }
  170. /** @typedef {import('utility-types').NonUndefined<Parameters<typeof deprecated>[1]>} DeprecatedOptions */
  171. /***/ }),
  172. /***/ "g56x":
  173. /***/ (function(module, exports) {
  174. (function() { module.exports = window["wp"]["hooks"]; }());
  175. /***/ })
  176. /******/ })["default"];