[Summary view] [Print] [Text view]

   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) {
 140    let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
 141    const {
 142      since,
 143      version,
 144      alternative,
 145      plugin,
 146      link,
 147      hint
 148    } = options;
 149    const pluginMessage = plugin ? ` from $plugin}` : '';
 150    const sinceMessage = since ? ` since version $since}` : '';
 151    const versionMessage = version ? ` and will be removed$pluginMessage} in version $version}` : '';
 152    const useInsteadMessage = alternative ? ` Please use $alternative} instead.` : '';
 153    const linkMessage = link ? ` See: $link}` : '';
 154    const hintMessage = hint ? ` Note: $hint}` : '';
 155    const message = `$feature} is deprecated$sinceMessage}$versionMessage}.$useInsteadMessage}$linkMessage}$hintMessage}`; // Skip if already logged.
 156  
 157    if (message in logged) {
 158      return;
 159    }
 160    /**
 161     * Fires whenever a deprecated feature is encountered
 162     *
 163     * @param {string}  feature             Name of the deprecated feature.
 164     * @param {?Object} options             Personalisation options
 165     * @param {string}  options.since       Version in which the feature was deprecated.
 166     * @param {?string} options.version     Version in which the feature will be removed.
 167     * @param {?string} options.alternative Feature to use instead
 168     * @param {?string} options.plugin      Plugin name if it's a plugin feature
 169     * @param {?string} options.link        Link to documentation
 170     * @param {?string} options.hint        Additional message to help transition away from the deprecated feature.
 171     * @param {?string} message             Message sent to console.warn
 172     */
 173  
 174  
 175    Object(_wordpress_hooks__WEBPACK_IMPORTED_MODULE_0__["doAction"])('deprecated', feature, options, message); // eslint-disable-next-line no-console
 176  
 177    console.warn(message);
 178    logged[message] = true;
 179  }
 180  /** @typedef {import('utility-types').NonUndefined<Parameters<typeof deprecated>[1]>} DeprecatedOptions */
 181  
 182  
 183  /***/ }),
 184  
 185  /***/ "g56x":
 186  /***/ (function(module, exports) {
 187  
 188  (function() { module.exports = window["wp"]["hooks"]; }());
 189  
 190  /***/ })
 191  
 192  /******/ })["default"];