191 lines
7.6 KiB
JavaScript
191 lines
7.6 KiB
JavaScript
|
this["wp"] = this["wp"] || {}; this["wp"]["deprecated"] =
|
||
|
|
/******/ (function(modules) { // webpackBootstrap
|
||
|
|
/******/ // The module cache
|
||
|
|
/******/ var installedModules = {};
|
||
|
|
/******/
|
||
|
|
/******/ // The require function
|
||
|
|
/******/ function __webpack_require__(moduleId) {
|
||
|
|
/******/
|
||
|
|
/******/ // Check if module is in cache
|
||
|
|
/******/ if(installedModules[moduleId]) {
|
||
|
|
/******/ return installedModules[moduleId].exports;
|
||
|
|
/******/ }
|
||
|
|
/******/ // Create a new module (and put it into the cache)
|
||
|
|
/******/ var module = installedModules[moduleId] = {
|
||
|
|
/******/ i: moduleId,
|
||
|
|
/******/ l: false,
|
||
|
|
/******/ exports: {}
|
||
|
|
/******/ };
|
||
|
|
/******/
|
||
|
|
/******/ // Execute the module function
|
||
|
|
/******/ modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
|
||
|
|
/******/
|
||
|
|
/******/ // Flag the module as loaded
|
||
|
|
/******/ module.l = true;
|
||
|
|
/******/
|
||
|
|
/******/ // Return the exports of the module
|
||
|
|
/******/ return module.exports;
|
||
|
|
/******/ }
|
||
|
|
/******/
|
||
|
|
/******/
|
||
|
|
/******/ // expose the modules object (__webpack_modules__)
|
||
|
|
/******/ __webpack_require__.m = modules;
|
||
|
|
/******/
|
||
|
|
/******/ // expose the module cache
|
||
|
|
/******/ __webpack_require__.c = installedModules;
|
||
|
|
/******/
|
||
|
|
/******/ // define getter function for harmony exports
|
||
|
|
/******/ __webpack_require__.d = function(exports, name, getter) {
|
||
|
|
/******/ if(!__webpack_require__.o(exports, name)) {
|
||
|
|
/******/ Object.defineProperty(exports, name, { enumerable: true, get: getter });
|
||
|
|
/******/ }
|
||
|
|
/******/ };
|
||
|
|
/******/
|
||
|
|
/******/ // define __esModule on exports
|
||
|
|
/******/ __webpack_require__.r = function(exports) {
|
||
|
|
/******/ if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
|
||
|
|
/******/ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
||
|
|
/******/ }
|
||
|
|
/******/ Object.defineProperty(exports, '__esModule', { value: true });
|
||
|
|
/******/ };
|
||
|
|
/******/
|
||
|
|
/******/ // create a fake namespace object
|
||
|
|
/******/ // mode & 1: value is a module id, require it
|
||
|
|
/******/ // mode & 2: merge all properties of value into the ns
|
||
|
|
/******/ // mode & 4: return value when already ns object
|
||
|
|
/******/ // mode & 8|1: behave like require
|
||
|
|
/******/ __webpack_require__.t = function(value, mode) {
|
||
|
|
/******/ if(mode & 1) value = __webpack_require__(value);
|
||
|
|
/******/ if(mode & 8) return value;
|
||
|
|
/******/ if((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;
|
||
|
|
/******/ var ns = Object.create(null);
|
||
|
|
/******/ __webpack_require__.r(ns);
|
||
|
|
/******/ Object.defineProperty(ns, 'default', { enumerable: true, value: value });
|
||
|
|
/******/ if(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key));
|
||
|
|
/******/ return ns;
|
||
|
|
/******/ };
|
||
|
|
/******/
|
||
|
|
/******/ // getDefaultExport function for compatibility with non-harmony modules
|
||
|
|
/******/ __webpack_require__.n = function(module) {
|
||
|
|
/******/ var getter = module && module.__esModule ?
|
||
|
|
/******/ function getDefault() { return module['default']; } :
|
||
|
|
/******/ function getModuleExports() { return module; };
|
||
|
|
/******/ __webpack_require__.d(getter, 'a', getter);
|
||
|
|
/******/ return getter;
|
||
|
|
/******/ };
|
||
|
|
/******/
|
||
|
|
/******/ // Object.prototype.hasOwnProperty.call
|
||
|
|
/******/ __webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
|
||
|
|
/******/
|
||
|
|
/******/ // __webpack_public_path__
|
||
|
|
/******/ __webpack_require__.p = "";
|
||
|
|
/******/
|
||
|
|
/******/
|
||
|
|
/******/ // Load entry module and return exports
|
||
|
|
/******/ return __webpack_require__(__webpack_require__.s = "+BeG");
|
||
|
|
/******/ })
|
||
|
|
/************************************************************************/
|
||
|
|
/******/ ({
|
||
|
|
|
||
|
|
/***/ "+BeG":
|
||
|
|
/***/ (function(module, __webpack_exports__, __webpack_require__) {
|
||
|
|
|
||
|
|
"use strict";
|
||
|
|
__webpack_require__.r(__webpack_exports__);
|
||
|
|
/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "logged", function() { return logged; });
|
||
|
|
/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "default", function() { return deprecated; });
|
||
|
|
/* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("g56x");
|
||
|
|
/* harmony import */ var _wordpress_hooks__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__);
|
||
|
|
/**
|
||
|
|
* WordPress dependencies
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Object map tracking messages which have been logged, for use in ensuring a
|
||
|
|
* message is only logged once.
|
||
|
|
*
|
||
|
|
* @type {Record<string, true | undefined>}
|
||
|
|
*/
|
||
|
|
|
||
|
|
const logged = Object.create(null);
|
||
|
|
/**
|
||
|
|
* Logs a message to notify developers about a deprecated feature.
|
||
|
|
*
|
||
|
|
* @param {string} feature Name of the deprecated feature.
|
||
|
|
* @param {Object} [options] Personalisation options
|
||
|
|
* @param {string} [options.since] Version in which the feature was deprecated.
|
||
|
|
* @param {string} [options.version] Version in which the feature will be removed.
|
||
|
|
* @param {string} [options.alternative] Feature to use instead
|
||
|
|
* @param {string} [options.plugin] Plugin name if it's a plugin feature
|
||
|
|
* @param {string} [options.link] Link to documentation
|
||
|
|
* @param {string} [options.hint] Additional message to help transition away from the deprecated feature.
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* ```js
|
||
|
|
* import deprecated from '@wordpress/deprecated';
|
||
|
|
*
|
||
|
|
* deprecated( 'Eating meat', {
|
||
|
|
* since: '2019.01.01'
|
||
|
|
* version: '2020.01.01',
|
||
|
|
* alternative: 'vegetables',
|
||
|
|
* plugin: 'the earth',
|
||
|
|
* hint: 'You may find it beneficial to transition gradually.',
|
||
|
|
* } );
|
||
|
|
*
|
||
|
|
* // 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.'
|
||
|
|
* ```
|
||
|
|
*/
|
||
|
|
|
||
|
|
function deprecated(feature, options = {}) {
|
||
|
|
const {
|
||
|
|
since,
|
||
|
|
version,
|
||
|
|
alternative,
|
||
|
|
plugin,
|
||
|
|
link,
|
||
|
|
hint
|
||
|
|
} = options;
|
||
|
|
const pluginMessage = plugin ? ` from ${plugin}` : '';
|
||
|
|
const sinceMessage = since ? ` since version ${since}` : '';
|
||
|
|
const versionMessage = version ? ` and will be removed${pluginMessage} in version ${version}` : '';
|
||
|
|
const useInsteadMessage = alternative ? ` Please use ${alternative} instead.` : '';
|
||
|
|
const linkMessage = link ? ` See: ${link}` : '';
|
||
|
|
const hintMessage = hint ? ` Note: ${hint}` : '';
|
||
|
|
const message = `${feature} is deprecated${sinceMessage}${versionMessage}.${useInsteadMessage}${linkMessage}${hintMessage}`; // Skip if already logged.
|
||
|
|
|
||
|
|
if (message in logged) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Fires whenever a deprecated feature is encountered
|
||
|
|
*
|
||
|
|
* @param {string} feature Name of the deprecated feature.
|
||
|
|
* @param {?Object} options Personalisation options
|
||
|
|
* @param {string} options.since Version in which the feature was deprecated.
|
||
|
|
* @param {?string} options.version Version in which the feature will be removed.
|
||
|
|
* @param {?string} options.alternative Feature to use instead
|
||
|
|
* @param {?string} options.plugin Plugin name if it's a plugin feature
|
||
|
|
* @param {?string} options.link Link to documentation
|
||
|
|
* @param {?string} options.hint Additional message to help transition away from the deprecated feature.
|
||
|
|
* @param {?string} message Message sent to console.warn
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
Object(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__["doAction"])('deprecated', feature, options, message); // eslint-disable-next-line no-console
|
||
|
|
|
||
|
|
console.warn(message);
|
||
|
|
logged[message] = true;
|
||
|
|
}
|
||
|
|
/** @typedef {import('utility-types').NonUndefined<Parameters<typeof deprecated>[1]>} DeprecatedOptions */
|
||
|
|
|
||
|
|
|
||
|
|
/***/ }),
|
||
|
|
|
||
|
|
/***/ "g56x":
|
||
|
|
/***/ (function(module, exports) {
|
||
|
|
|
||
|
|
(function() { module.exports = window["wp"]["hooks"]; }());
|
||
|
|
|
||
|
|
/***/ })
|
||
|
|
|
||
|
|
/******/ })["default"];
|