deprecated.js (7759B)
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 90 /***/ "+BeG": 91 /***/ (function(module, __webpack_exports__, __webpack_require__) { 92 93 "use strict"; 94 __webpack_require__.r(__webpack_exports__); 95 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "logged", function() { return logged; }); 96 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "default", function() { return deprecated; }); 97 /* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("g56x"); 98 /* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__); 99 /** 100 * WordPress dependencies 101 */ 102 103 /** 104 * Object map tracking messages which have been logged, for use in ensuring a 105 * message is only logged once. 106 * 107 * @type {Record<string, true | undefined>} 108 */ 109 110 const logged = Object.create(null); 111 /** 112 * Logs a message to notify developers about a deprecated feature. 113 * 114 * @param {string} feature Name of the deprecated feature. 115 * @param {Object} [options] Personalisation options 116 * @param {string} [options.since] Version in which the feature was deprecated. 117 * @param {string} [options.version] Version in which the feature will be removed. 118 * @param {string} [options.alternative] Feature to use instead 119 * @param {string} [options.plugin] Plugin name if it's a plugin feature 120 * @param {string} [options.link] Link to documentation 121 * @param {string} [options.hint] Additional message to help transition away from the deprecated feature. 122 * 123 * @example 124 * ```js 125 * import deprecated from '@wordpress/deprecated'; 126 * 127 * deprecated( 'Eating meat', { 128 * since: '2019.01.01' 129 * version: '2020.01.01', 130 * alternative: 'vegetables', 131 * plugin: 'the earth', 132 * hint: 'You may find it beneficial to transition gradually.', 133 * } ); 134 * 135 * // 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.' 136 * ``` 137 */ 138 139 function deprecated(feature, options = {}) { 140 const { 141 since, 142 version, 143 alternative, 144 plugin, 145 link, 146 hint 147 } = options; 148 const pluginMessage = plugin ? ` from ${plugin}` : ''; 149 const sinceMessage = since ? ` since version ${since}` : ''; 150 const versionMessage = version ? ` and will be removed${pluginMessage} in version ${version}` : ''; 151 const useInsteadMessage = alternative ? ` Please use ${alternative} instead.` : ''; 152 const linkMessage = link ? ` See: ${link}` : ''; 153 const hintMessage = hint ? ` Note: ${hint}` : ''; 154 const message = `${feature} is deprecated${sinceMessage}${versionMessage}.${useInsteadMessage}${linkMessage}${hintMessage}`; // Skip if already logged. 155 156 if (message in logged) { 157 return; 158 } 159 /** 160 * Fires whenever a deprecated feature is encountered 161 * 162 * @param {string} feature Name of the deprecated feature. 163 * @param {?Object} options Personalisation options 164 * @param {string} options.since Version in which the feature was deprecated. 165 * @param {?string} options.version Version in which the feature will be removed. 166 * @param {?string} options.alternative Feature to use instead 167 * @param {?string} options.plugin Plugin name if it's a plugin feature 168 * @param {?string} options.link Link to documentation 169 * @param {?string} options.hint Additional message to help transition away from the deprecated feature. 170 * @param {?string} message Message sent to console.warn 171 */ 172 173 174 Object(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__["doAction"])('deprecated', feature, options, message); // eslint-disable-next-line no-console 175 176 console.warn(message); 177 logged[message] = true; 178 } 179 /** @typedef {import('utility-types').NonUndefined<Parameters<typeof deprecated>[1]>} DeprecatedOptions */ 180 181 182 /***/ }), 183 184 /***/ "g56x": 185 /***/ (function(module, exports) { 186 187 (function() { module.exports = window["wp"]["hooks"]; }()); 188 189 /***/ }) 190 191 /******/ })["default"];