WordPress core abilities integration for the Abilities API.

This package provides the integration layer between the @wordpress/abilities package and WordPress REST API. It fetches and registers all abilities and categories from the WordPress server.

Install the module:

npm install @wordpress/core-abilities --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/or APIs, you should include the polyfill shipped in @wordpress/babel-preset-default in your code.

This package is designed to be loaded as a script module on WordPress admin pages. When loaded, it automatically:

1. Fetches all ability categories from /wp-abilities/v1/categories
2. Registers them with @wordpress/abilities
3. Fetches all abilities from /wp-abilities/v1/abilities
4. Registers them with a callback that handles execution via REST API

Simply import the package to initialize the WordPress abilities:

import '@wordpress/core-abilities';

Initialization is asynchronous because categories and abilities are fetched from the REST API. To wait for registration to finish before calling getAbilities() or executeAbility(), await the exported ready promise:

import { ready } from '@wordpress/core-abilities';
import { getAbilities, executeAbility } from '@wordpress/abilities';

await ready;

console.log( getAbilities() );
console.log( await executeAbility( 'core/get-site-info' ) );

To defer the network requests until a feature actually needs abilities, import the package dynamically from that feature — the module (and therefore its requests) only loads when the import() call runs:

await import( '@wordpress/core-abilities' );

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.