Norwegian Polka Music

    @wordpress/deprecated
    TypeScript icon, indicating that this package has built-in type declarations

    3.15.0 • Public • Published

    Deprecated

    Deprecation utility for WordPress. Logs a message to notify developers about a deprecated feature.

    Installation

    Install the module

    npm install @wordpress/deprecated --save

    This package assumes that your code will run in an ES2015+ environment. If you're using an environment that has limited or no support for such language features and APIs, you should include the polyfill shipped in @wordpress/babel-preset-default in your code.

    Hook

    The deprecated action is fired with three parameters: the name of the deprecated feature, the options object passed to deprecated, and the message sent to the console.

    Example:

    import { addAction } from '@wordpress/hooks';
    
    function addDeprecationAlert( message, { version } ) {
    	alert( `Deprecation: ${ message }. Version: ${ version }` );
    }
    
    addAction(
    	'deprecated',
    	'my-plugin/add-deprecation-alert',
    	addDeprecationAlert
    );

    API

    default

    Logs a message to notify developers about a deprecated feature.

    Usage

    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.'

    Parameters

    • feature string: Name of the deprecated feature.
    • options [Object]: Personalisation options
    • options.since [string]: Version in which the feature was deprecated.
    • options.version [string]: Version in which the feature will be removed.
    • options.alternative [string]: Feature to use instead
    • options.plugin [string]: Plugin name if it's a plugin feature
    • options.link [string]: Link to documentation
    • options.hint [string]: Additional message to help transition away from the deprecated feature.

    logged

    Object map tracking messages which have been logged, for use in ensuring a message is only logged once.

    Type

    • Record<string, true | undefined>

    Contributing to this package

    This is an individual package that's part of the Gutenberg project. The project is organized as a monorepo. It's made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to npm and used by WordPress as well as other software projects.

    To find out more about contributing to this package or Gutenberg as a whole, please read the project's main contributor guide.



    Code is Poetry.

    Install

    npm i @wordpress/deprecated

    DownloadsWeekly Downloads

    32,091

    Version

    3.15.0

    License

    GPL-2.0-or-later

    Unpacked Size

    77.5 kB

    Total Files

    14

    Last publish

    Collaborators

    • gutenbergplugin
    • mamaduka
    • ryanwelcher
    • adamziel
    • garypendergast
    • aduth
    • riad
    • adamsilverstein
    • gziolo
    • ntwb
    • noisysocks
    • kadamwhite
    • jorgefilipecosta
    • ellatrix
    • iandunn206
    • whyisjake
    • ockham
    • sirreal
    • nosolosw
    • wpisabel
    • ntsekouras
    • nerrad
    • desrosj
    • talldanwp
    • peterwilsoncc