@microsoft/api-extractor-model

Use this library to read and write *.api.json files as defined by the API Extractor tool. These files are used to generate a documentation website for your TypeScript package. The files store the API signatures and doc comments that were extracted from your package.

API documentation for this package: https://api.rushstack.io/pages/api-extractor-model/

Example Usage

The following code sample shows how to load example.api.json, which would be generated by API Extractor when it analyzes a hypothetical NPM package called example:

import { ApiModel, ApiPackage } from '@microsoft/api-extractor-model';

const apiModel: ApiModel = new ApiModel();
const apiPackage: ApiPackage = apiModel.loadPackage('example.api.json');

for (const member of apiPackage.members) {
  console.log(member.displayName);
}

The ApiModel is acts as a container for various packages that are loaded and operated on as a group. For example, a documentation tool may need to resolve @link references across different packages. In this case we would load the various packages into the ApiModel, and then use the ApiModel.resolveDeclarationReference() to resolve the @link targets.

The data structure forms a tree of various classes that start with the Api prefix. The nesting hierarchy might look like this:

- ApiModel
  - ApiPackage
    - ApiEntryPoint
      - ApiClass
        - ApiMethod
        - ApiProperty
      - ApiEnum
        - ApiEnumMember
      - ApiInterface
        - ApiMethodSignature
        - ApiPropertySignature
      - ApiNamespace
        - (ApiClass, ApiEnum, ApiInterface, ...)

You can use the ApiItem.members property to traverse this tree.

Note that the non-abstract classes (e.g. ApiClass, ApiEnum, ApiInterface, etc.) use TypeScript "mixin" functions (e.g. ApiDeclaredItem, ApiItemContainerMixin, etc.) to add various features that cannot be represented as a normal inheritance chain (since TypeScript does not allow a child class to extend more than one base class). The "mixin" is a TypeScript merged declaration with three components: the function that generates a subclass, an interface that describes the members of the subclass, and a namespace containing static members of the class.

For a complete project that uses these APIs to generate an API reference web site, see the @microsoft/api-documenter source code.

Links

• CHANGELOG.md - Find out what's new in the latest version
• API Reference

API Extractor is part of the Rush Stack family of projects.

Change Log - @microsoft/api-extractor-model

This log was last generated on Tue, 25 Mar 2025 15:11:15 GMT and should not be manually modified.

7.30.5

Tue, 25 Mar 2025 15:11:15 GMT

Version update only

7.30.4

Tue, 11 Mar 2025 02:12:33 GMT

Version update only

7.30.3

Thu, 30 Jan 2025 01:11:42 GMT

Version update only

7.30.2

Thu, 09 Jan 2025 01:10:10 GMT

Version update only

7.30.1

Sat, 14 Dec 2024 01:11:07 GMT

Version update only

7.30.0

Sat, 23 Nov 2024 01:18:55 GMT

Minor changes

• Update TSDoc dependencies.

7.29.9

Fri, 22 Nov 2024 01:10:43 GMT

Version update only

7.29.8

Fri, 13 Sep 2024 00:11:43 GMT

Version update only

7.29.7

Tue, 10 Sep 2024 20:08:11 GMT

Version update only

7.29.6

Wed, 21 Aug 2024 05:43:04 GMT

Version update only

7.29.5

Mon, 12 Aug 2024 22:16:04 GMT

Version update only

7.29.4

Sat, 27 Jul 2024 00:10:27 GMT

Patches

• Include CHANGELOG.md in published releases again

7.29.3

Tue, 16 Jul 2024 00:36:21 GMT

Version update only

7.29.2

Thu, 30 May 2024 00:13:05 GMT

Patches

• Include missing type modifiers on type-only exports.

7.29.1

Wed, 29 May 2024 02:03:51 GMT

Version update only

7.29.0

Wed, 29 May 2024 00:10:52 GMT

Minor changes

• Bump TSDoc dependencies.

7.28.21

Tue, 28 May 2024 15:10:09 GMT

Version update only

7.28.20

Tue, 28 May 2024 00:09:47 GMT

Version update only

7.28.19

Sat, 25 May 2024 04:54:08 GMT

Version update only

7.28.18

Thu, 23 May 2024 02:26:56 GMT

Version update only

7.28.17

Wed, 15 May 2024 06:04:17 GMT

Version update only

7.28.16

Fri, 10 May 2024 05:33:34 GMT

Version update only

7.28.15

Mon, 06 May 2024 15:11:05 GMT

Version update only

7.28.14

Wed, 10 Apr 2024 15:10:08 GMT

Version update only

7.28.13

Wed, 21 Feb 2024 21:45:28 GMT

Version update only

7.28.12

Tue, 20 Feb 2024 21:45:10 GMT

Version update only

7.28.11

Mon, 19 Feb 2024 21:54:26 GMT

Patches

• Fix a formatting issue with the LICENSE.

7.28.10

Sat, 17 Feb 2024 06:24:34 GMT

Patches

• Fix broken link to API documentation

7.28.9

Thu, 08 Feb 2024 01:09:22 GMT

Version update only

7.28.8

Mon, 05 Feb 2024 23:46:52 GMT

Version update only

7.28.7

Thu, 25 Jan 2024 01:09:30 GMT

Version update only

7.28.6

Tue, 23 Jan 2024 20:12:58 GMT

Version update only

7.28.5

Tue, 23 Jan 2024 16:15:05 GMT

Version update only

7.28.4

Wed, 03 Jan 2024 00:31:18 GMT

Version update only

7.28.3

Thu, 07 Dec 2023 03:44:13 GMT

Version update only

7.28.2

Thu, 28 Sep 2023 20:53:16 GMT

Version update only

7.28.1

Tue, 26 Sep 2023 09:30:33 GMT

Patches

• Update type-only imports to include the type modifier.

7.28.0

Fri, 15 Sep 2023 00:36:58 GMT

Minor changes

• Update @types/node from 14 to 18

7.27.6

Tue, 08 Aug 2023 07:10:40 GMT

Version update only

7.27.5

Wed, 19 Jul 2023 00:20:32 GMT

Version update only

7.27.4

Thu, 06 Jul 2023 00:16:20 GMT

Version update only

7.27.3

Thu, 15 Jun 2023 00:21:01 GMT

Version update only

7.27.2

Wed, 07 Jun 2023 22:45:16 GMT

Version update only

7.27.1

Mon, 29 May 2023 15:21:15 GMT

Version update only

7.27.0

Mon, 22 May 2023 06:34:32 GMT

Minor changes

• Upgrade the TypeScript dependency to ~5.0.4

7.26.9

Fri, 12 May 2023 00:23:05 GMT

Version update only

7.26.8

Thu, 04 May 2023 00:20:28 GMT

Patches

• Fix a mistake in the documentation for ApiParameterListMixin.overloadIndex

7.26.7

Mon, 01 May 2023 15:23:20 GMT

Version update only

7.26.6

Sat, 29 Apr 2023 00:23:03 GMT

Version update only

7.26.5

Thu, 27 Apr 2023 17:18:43 GMT

Version update only

7.26.4

Fri, 10 Feb 2023 01:18:51 GMT

Version update only

7.26.3

Sun, 05 Feb 2023 03:02:02 GMT

Version update only

7.26.2

Wed, 01 Feb 2023 02:16:34 GMT

Version update only

7.26.1

Mon, 30 Jan 2023 16:22:30 GMT

Version update only

7.26.0

Wed, 25 Jan 2023 07:26:55 GMT

Minor changes

• Add new .api.json field isAbstract to track abstract modifier in ApiClass, ApiMethod, and ApiProperty via ApiAbstractMixin (GitHub #3661)

7.25.3

Fri, 09 Dec 2022 16:18:28 GMT

Version update only

7.25.2

Wed, 26 Oct 2022 00:16:16 GMT

Patches

• Update the @microsoft/tsdoc dependency version to 0.14.2.

7.25.1

Thu, 13 Oct 2022 00:20:15 GMT

Version update only

7.25.0

Tue, 11 Oct 2022 23:49:12 GMT

Minor changes

• Add a new fileUrlPath property to relevant API items and serialize this to the .api.json. Additionally, add a SourceFile helper class for constructing file URLs from these paths and the projectFolderUrl.

7.24.4

Mon, 10 Oct 2022 15:23:44 GMT

Version update only

7.24.3

Thu, 29 Sep 2022 07:13:06 GMT

Version update only

7.24.2

Wed, 21 Sep 2022 20:21:10 GMT

Version update only

7.24.1

Thu, 15 Sep 2022 00:18:52 GMT

Version update only

7.24.0

Fri, 02 Sep 2022 17:48:42 GMT

Minor changes

• Add new ApiExportedMixin mixin class for determining whether an API item is exported or not

7.23.3

Wed, 24 Aug 2022 03:01:22 GMT

Version update only

7.23.2

Wed, 24 Aug 2022 00:14:38 GMT

Patches

• Remove use of LegacyAdapters.sortStable

7.23.1

Fri, 19 Aug 2022 00:17:19 GMT

Version update only

7.23.0

Wed, 03 Aug 2022 18:40:35 GMT

Minor changes

• Upgrade TypeScript dependency to 4.7

7.22.2

Mon, 01 Aug 2022 02:45:32 GMT

Version update only

7.22.1

Thu, 21 Jul 2022 23:30:27 GMT

Patches

• Improve IFindApiItemMessage and fix two small bugs with ApiItemContainerMixin.findMembersWithInheritance()

7.22.0

Thu, 21 Jul 2022 00:16:14 GMT

Minor changes

• Add a new ApiItemContainerMixin.findMembersWithInheritance() method for finding an item's inherited members

7.21.0

Thu, 30 Jun 2022 04:48:53 GMT

Minor changes

• Update model to reflect that index signatures can also be readonly

7.20.3

Tue, 28 Jun 2022 22:47:13 GMT

Version update only

7.20.2

Tue, 28 Jun 2022 00:23:32 GMT

Version update only

7.20.1

Mon, 27 Jun 2022 18:43:09 GMT

Version update only

7.20.0

Sat, 25 Jun 2022 21:00:40 GMT

Minor changes

• Add a new initializerTokenRange field to ApiProperty and ApiVariable items.

7.19.1

Sat, 25 Jun 2022 01:54:29 GMT

Version update only

7.19.0

Fri, 24 Jun 2022 07:16:47 GMT

Minor changes

• Added new configuration for ItemContainerMixin member ordering

7.18.2

Fri, 17 Jun 2022 09:17:54 GMT

Version update only

7.18.1

Fri, 17 Jun 2022 00:16:18 GMT

Version update only

7.18.0

Tue, 07 Jun 2022 09:37:04 GMT

Minor changes

• Add an "isReadonly" field to ApiProperty, ApiPropertySignature, and ApiVariable
• Add an "isProtected" field to ApiConstructor, ApiMethod, and ApiProperty

7.17.3

Tue, 10 May 2022 01:20:43 GMT

Version update only

7.17.2

Sat, 23 Apr 2022 02:13:07 GMT

Version update only

7.17.1

Fri, 15 Apr 2022 00:12:36 GMT

Version update only

7.17.0

Wed, 13 Apr 2022 15:12:40 GMT

Minor changes

• Add a new isOptional property to TypeParameters deserialized from the .api.json file with api-extractor-model.

7.16.2

Tue, 12 Apr 2022 02:58:32 GMT

Patches

• Update TSDoc dependencies.

7.16.1

Sat, 09 Apr 2022 02:24:26 GMT

Patches

• Rename the "master" branch to "main".
• Update a path in the README.

7.16.0

Thu, 31 Mar 2022 02:06:05 GMT

Minor changes

• Updated api-extractor-model to store whether a parameter is optional.

7.15.4

Tue, 15 Mar 2022 19:15:53 GMT

Version update only

7.15.3

Wed, 05 Jan 2022 16:07:47 GMT

Version update only

7.15.2

Mon, 27 Dec 2021 16:10:40 GMT

Version update only

7.15.1

Thu, 09 Dec 2021 20:34:41 GMT

Version update only

7.15.0

Thu, 09 Dec 2021 00:21:54 GMT

Minor changes

• Replace const enums with conventional enums to allow for compatibility with JavaScript consumers.

7.14.0

Wed, 08 Dec 2021 16:14:05 GMT

Minor changes

• Update to TypeScript 4.5

7.13.18

Mon, 06 Dec 2021 16:08:33 GMT

Version update only

7.13.17

Fri, 03 Dec 2021 03:05:22 GMT

Version update only

7.13.16

Sat, 06 Nov 2021 00:09:13 GMT

Version update only

7.13.15

Fri, 05 Nov 2021 15:09:18 GMT

Version update only

7.13.14

Wed, 27 Oct 2021 00:08:15 GMT

Patches

• Update the package.json repository field to include the directory property.

7.13.13

Wed, 13 Oct 2021 15:09:54 GMT

Version update only

7.13.12

Fri, 08 Oct 2021 08:08:34 GMT

Version update only

7.13.11

Thu, 07 Oct 2021 07:13:35 GMT

Version update only

7.13.10

Tue, 05 Oct 2021 15:08:38 GMT

Version update only

7.13.9

Fri, 24 Sep 2021 00:09:29 GMT

Version update only

7.13.8

Thu, 23 Sep 2021 00:10:40 GMT

Patches

• Upgrade the @types/node dependency to version to version 12.

7.13.7

Tue, 14 Sep 2021 01:17:04 GMT

Version update only

7.13.6

Mon, 13 Sep 2021 15:07:06 GMT

Version update only

7.13.5

Wed, 11 Aug 2021 00:07:21 GMT

Version update only

7.13.4

Mon, 12 Jul 2021 23:08:26 GMT

Version update only

7.13.3

Fri, 04 Jun 2021 19:59:53 GMT

Version update only

7.13.2

Wed, 19 May 2021 00:11:39 GMT

Version update only

7.13.1

Mon, 03 May 2021 15:10:29 GMT

Version update only

7.13.0

Tue, 20 Apr 2021 04:59:51 GMT

Minor changes

• The .api.json file format now stores the TSDoc configuration used for parsing doc comments

7.12.5

Mon, 12 Apr 2021 15:10:28 GMT

Version update only

7.12.4

Thu, 08 Apr 2021 06:05:31 GMT

Patches

• Fix minor typo in README.md

7.12.3

Tue, 06 Apr 2021 15:14:22 GMT

Version update only

7.12.2

Fri, 05 Feb 2021 16:10:42 GMT

Version update only

7.12.1

Thu, 10 Dec 2020 23:25:49 GMT

Patches

• Enable support for @decorator

7.12.0

Wed, 18 Nov 2020 08:19:54 GMT

Minor changes

• Introduce an ApiOptionalMixin base class for representing optional properties and methods

7.11.0

Wed, 18 Nov 2020 06:21:57 GMT

Minor changes

• Update .api.json file format to store a new field "isOptional" for documenting optional properties

7.10.10

Wed, 11 Nov 2020 01:08:59 GMT

Version update only

7.10.9

Tue, 10 Nov 2020 23:13:12 GMT

Version update only

7.10.8

Fri, 30 Oct 2020 06:38:39 GMT

Version update only

7.10.7

Fri, 30 Oct 2020 00:10:14 GMT

Version update only

7.10.6

Thu, 29 Oct 2020 06:14:19 GMT

Patches

• Fix .d.ts error when the library is imported by a project using TypeScript 4.0

7.10.5

Wed, 28 Oct 2020 01:18:03 GMT

Version update only

7.10.4

Tue, 27 Oct 2020 15:10:14 GMT

Version update only

7.10.3

Tue, 06 Oct 2020 00:24:06 GMT

Version update only

7.10.2

Mon, 05 Oct 2020 22:36:57 GMT

Version update only

7.10.1

Wed, 30 Sep 2020 18:39:17 GMT

Patches

• Update to build with @rushstack/heft-node-rig

7.10.0

Wed, 30 Sep 2020 06:53:53 GMT

Minor changes

• Upgrade compiler; the API now requires TypeScript 3.9 or newer

Patches

• Update README.md

7.9.7

Tue, 22 Sep 2020 05:45:57 GMT

Version update only

7.9.6

Tue, 22 Sep 2020 01:45:31 GMT

Version update only

7.9.5

Tue, 22 Sep 2020 00:08:53 GMT

Version update only

7.9.4

Sat, 19 Sep 2020 04:37:27 GMT

Version update only

7.9.3

Sat, 19 Sep 2020 03:33:07 GMT

Version update only

7.9.2

Fri, 18 Sep 2020 22:57:24 GMT

Version update only

7.9.1

Fri, 18 Sep 2020 21:49:54 GMT

Version update only

7.9.0

Sun, 13 Sep 2020 01:53:20 GMT

Minor changes

• Add support for system selectors in declaration references

7.8.22

Fri, 11 Sep 2020 02:13:35 GMT

Version update only

7.8.21

Mon, 07 Sep 2020 07:37:37 GMT

Version update only

7.8.20

Sat, 05 Sep 2020 18:56:34 GMT

Patches

• Fix "Converting circular structure to JSON" error (GitHub #2152)

7.8.19

Thu, 27 Aug 2020 11:27:06 GMT

Version update only

7.8.18

Mon, 24 Aug 2020 07:35:20 GMT

Version update only

7.8.17

Sat, 22 Aug 2020 05:55:43 GMT

Version update only

7.8.16

Tue, 18 Aug 2020 23:59:42 GMT

Version update only

7.8.15

Mon, 17 Aug 2020 04:53:23 GMT

Version update only

7.8.14

Wed, 12 Aug 2020 00:10:05 GMT

Patches

• Updated project to build with Heft

7.8.13

Wed, 05 Aug 2020 18:27:33 GMT

Version update only

7.8.12

Fri, 03 Jul 2020 15:09:04 GMT

Version update only

7.8.11

Thu, 25 Jun 2020 06:43:35 GMT

Version update only

7.8.10

Wed, 24 Jun 2020 09:50:48 GMT

Version update only

7.8.9

Wed, 24 Jun 2020 09:04:28 GMT

Version update only

7.8.8

Wed, 10 Jun 2020 20:48:30 GMT

Version update only

7.8.7

Sat, 30 May 2020 02:59:54 GMT

Version update only

7.8.6

Thu, 28 May 2020 05:59:02 GMT

Version update only

7.8.5

Wed, 27 May 2020 05:15:11 GMT

Version update only

7.8.4

Tue, 26 May 2020 23:00:25 GMT

Version update only

7.8.3

Fri, 22 May 2020 15:08:43 GMT

Version update only

7.8.2

Thu, 21 May 2020 23:09:44 GMT

Version update only

7.8.1

Thu, 21 May 2020 15:42:00 GMT

Version update only

7.8.0

Wed, 06 May 2020 08:23:45 GMT

Minor changes

• Enable canonicalReference to ApiItem lookup

7.7.11

Wed, 08 Apr 2020 04:07:33 GMT

Version update only

7.7.10

Sat, 28 Mar 2020 00:37:16 GMT

Patches

• Upgrade to TSdoc 0.12.19

7.7.9

Wed, 18 Mar 2020 15:07:47 GMT

Patches

• Upgrade cyclic dependencies

7.7.8

Tue, 17 Mar 2020 23:55:58 GMT

Patches

• Replace dependencies whose NPM scope was renamed from @microsoft to @rushstack

7.7.7

Tue, 28 Jan 2020 02:23:44 GMT

Version update only

7.7.6

Thu, 23 Jan 2020 01:07:56 GMT

Version update only

7.7.5

Tue, 21 Jan 2020 21:56:14 GMT

Version update only

7.7.4

Sun, 19 Jan 2020 02:26:52 GMT

Patches

• Upgrade Node typings to Node 10

7.7.3

Fri, 17 Jan 2020 01:08:23 GMT

Version update only

7.7.2

Thu, 09 Jan 2020 06:44:13 GMT

Version update only

7.7.1

Wed, 08 Jan 2020 00:11:31 GMT

Version update only

7.7.0

Tue, 03 Dec 2019 03:17:43 GMT

Minor changes

• Improve declaration reference syntax to allow linking to overloaded functions/methods

7.6.0

Sun, 24 Nov 2019 00:54:04 GMT

Minor changes

• Added support for @throws

7.5.6

Fri, 15 Nov 2019 04:50:50 GMT

Version update only

7.5.5

Mon, 11 Nov 2019 16:07:56 GMT

Version update only

7.5.4

Tue, 05 Nov 2019 06:49:28 GMT

Patches

• Fix an issue where API reports sometimes were ordered differently depending on the version of NodeJS (GitHub #1552)

7.5.3

Tue, 05 Nov 2019 01:08:39 GMT

Patches

• Clarified an error message

7.5.2

Tue, 22 Oct 2019 06:24:44 GMT

Patches

• Refactor some code as part of migration from TSLint to ESLint

7.5.1

Sun, 29 Sep 2019 23:56:29 GMT

Patches

• Update repository URL

7.5.0

Wed, 25 Sep 2019 15:15:31 GMT

Minor changes

• Add ApiItem.getMergedSiblings() API

7.4.2

Mon, 23 Sep 2019 15:14:55 GMT

Patches

• Remove unnecessary dependency on @types/node

7.4.1

Tue, 10 Sep 2019 22:32:23 GMT

Patches

• Update documentation

7.4.0

Tue, 10 Sep 2019 20:38:33 GMT

Minor changes

• Add 'canonicalReference' to ExcerptToken

7.3.4

Wed, 04 Sep 2019 18:28:06 GMT

Version update only

7.3.3

Wed, 04 Sep 2019 15:15:37 GMT

Patches

• Update TSDoc dependency to 0.12.14

7.3.2

Thu, 08 Aug 2019 15:14:17 GMT

Version update only

7.3.1

Thu, 08 Aug 2019 00:49:05 GMT

Patches

• (Experimental) Add ApiExtractor.canonicalReference which is a beta implementation of the revised TSDoc declaration reference notation

7.3.0

Mon, 22 Jul 2019 19:13:10 GMT

Minor changes

• Rename ApiItem.canonicalReference to .containerKey; rename ApiItemContainerMixin.tryGetMember() to .tryGetMemberByKey(); rename Api___.getCanonicalReference() to .getContainerKey()

7.2.0

Tue, 11 Jun 2019 00:48:06 GMT

Minor changes

• Add API support for type parameters and type alias types

Patches

• Improve the .api.json deserializer to validate the schema version and support backwards compatibility

7.1.3

Wed, 05 Jun 2019 19:12:34 GMT

Patches

• Fix an issue where TSDoc index selectors (ApiParameterListMixin.overloadIndex) started from 0, whereas TSDoc requires a nonzero number

7.1.2

Tue, 04 Jun 2019 05:51:53 GMT

Patches

• Fix an issue where ApiConstructor inherited from ApiStaticMixin, but TypeScript constructors cannot be static

7.1.1

Mon, 27 May 2019 04:13:44 GMT

Patches

• Make the strings returned by ApiItem.displayName less verbose
• Improve formatting of the strings returned by ApiItem.getScopedNameWithinPackage()

7.1.0

Tue, 16 Apr 2019 11:01:37 GMT

Minor changes

• Initial stable release of API Extractor 7

7.0.28

Wed, 20 Mar 2019 19:14:49 GMT

Version update only

7.0.27

Mon, 18 Mar 2019 04:28:43 GMT

Patches

• Add helper functions for ReleaseTag
• Export IApiItemConstructor to eliminate the ae-forgotten-export warning

7.0.26

Wed, 13 Mar 2019 19:13:14 GMT

Patches

• Refactor code to move the IndentedWriter API from api-extractor-model to api-documenter

7.0.25

Wed, 13 Mar 2019 01:14:05 GMT

Patches

• Upgrade TSDoc

7.0.24

Mon, 11 Mar 2019 16:13:36 GMT

Patches

• Initial setup of new package @microsoft/api-extractor-model