2019-11-05 14:55:08 -05:00
|
|
|
---
|
|
|
|
title: npm-docs
|
2020-11-01 07:54:36 +01:00
|
|
|
section: 1
|
|
|
|
description: Open documentation for a package in a web browser
|
2019-11-05 14:55:08 -05:00
|
|
|
---
|
|
|
|
|
|
|
|
### Synopsis
|
|
|
|
|
|
|
|
```bash
|
|
|
|
npm docs [<pkgname> [<pkgname> ...]]
|
2020-10-02 17:52:19 -04:00
|
|
|
|
|
|
|
aliases: home
|
2019-11-05 14:55:08 -05:00
|
|
|
```
|
|
|
|
|
|
|
|
### Description
|
|
|
|
|
|
|
|
This command tries to guess at the likely location of a package's
|
2020-11-01 07:54:36 +01:00
|
|
|
documentation URL, and then tries to open it using the `--browser` config
|
|
|
|
param. You can pass multiple package names at once. If no package name is
|
|
|
|
provided, it will search for a `package.json` in the current folder and use
|
|
|
|
the `name` property.
|
2019-11-05 14:55:08 -05:00
|
|
|
|
|
|
|
### Configuration
|
|
|
|
|
|
|
|
#### browser
|
|
|
|
|
|
|
|
* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
|
2020-10-02 17:52:19 -04:00
|
|
|
* Type: String or Boolean
|
2019-11-05 14:55:08 -05:00
|
|
|
|
|
|
|
The browser that is called by the `npm docs` command to open websites.
|
|
|
|
|
2020-10-02 17:52:19 -04:00
|
|
|
Set to `false` to suppress browser behavior and instead print urls to
|
|
|
|
terminal.
|
|
|
|
|
|
|
|
Set to `true` to use default system URL opener.
|
|
|
|
|
2019-11-05 14:55:08 -05:00
|
|
|
#### registry
|
|
|
|
|
|
|
|
* Default: https://registry.npmjs.org/
|
|
|
|
* Type: url
|
|
|
|
|
|
|
|
The base URL of the npm package registry.
|
|
|
|
|
2021-04-01 17:27:18 -04:00
|
|
|
#### workspaces
|
|
|
|
|
|
|
|
Enables workspaces context while searching the `package.json` in the
|
|
|
|
current folder. Documentation urls for the packages named in each
|
|
|
|
workspace will be opened.
|
|
|
|
|
|
|
|
#### workspace
|
|
|
|
|
|
|
|
Enables workspaces context and limits results to only those specified by
|
|
|
|
this config item. Only the documentation urls for the packages named in
|
|
|
|
the workspaces given here will be opened.
|
|
|
|
|
|
|
|
|
2019-11-05 14:55:08 -05:00
|
|
|
### See Also
|
|
|
|
|
2020-11-01 07:54:36 +01:00
|
|
|
* [npm view](/commands/npm-view)
|
|
|
|
* [npm publish](/commands/npm-publish)
|
2019-11-05 14:55:08 -05:00
|
|
|
* [npm registry](/using-npm/registry)
|
2020-11-01 07:54:36 +01:00
|
|
|
* [npm config](/commands/npm-config)
|
2019-11-05 14:55:08 -05:00
|
|
|
* [npmrc](/configuring-npm/npmrc)
|
|
|
|
* [package.json](/configuring-npm/package-json)
|