Introducción
Contenido
- 1 Introducción
- 2 Configuración de parámetros
- 3 Lista de posibles parámetros
- 3.0.1 Control de acceso / autorización
- 3.0.2 Almacenamiento en caché
- 3.0.3 General
- 3.0.3.1 color
- 3.0.3.2 descripción
- 3.0.3.3 fuerza
- 3.0.3.4 global
- 3.0.3.5 globalconfig
- 3.0.3.6 grupo
- 3.0.3.7 largo
- 3.0.3.8 prefijo
- 3.0.3.9 girar
- 3.0.3.10 tmp
- 3.0.3.11 Unicode
- 3.0.3.12 permanente insegura
- 3.0.3.13 uso
- 3.0.3.14 usuario
- 3.0.3.15 userconfig
- 3.0.3.16 umask
- 3.0.3.17 versión
- 3.0.3.18 versiones
- 3.0.3.19 espectador
- 3.0.4 Desarrollo
- 3.0.4.1 dev
- 3.0.4.2 editor
- 3.0.4.3 motor-estricto
- 3.0.4.4 Vamos
- 3.0.4.5 git-tag-version
- 3.0.4.6 Bóveda
- 3.0.4.7 si está presente
- 3.0.4.8 ignorar guiones
- 3.0.4.9 módulo de inicio
- 3.0.4.10 nombre-autor-init
- 3.0.4.11 init-author-email
- 3.0.4.12 init-author-url
- 3.0.4.13 init-licencia
- 3.0.4.14 init-version
- 3.0.4.15 json
- 3.0.4.16 enlace
- 3.0.4.17 dirección local
- 3.0.4.18 nivel de registro
- 3.0.4.19 corriente de registro
- 3.0.4.20 mensaje
- 3.0.4.21 versión de node
- 3.0.4.22 npat
- 3.0.4.23 onload-script
- 3.0.4.24 Opcional
- 3.0.4.25 analizable
- 3.0.4.26 producción
- 3.0.4.27 Retroceder
- 3.0.4.28 salvar
- 3.0.4.29 guardar-paquete
- 3.0.4.30 save-dev
- 3.0.4.31 guardar-exacto
- 3.0.4.32 guardar-opcional
- 3.0.4.33 guardar-prefijo
- 3.0.4.34 alcance
- 3.0.4.35 Envoltura retráctil
- 3.0.4.36 sign-git-tag
- 3.0.4.37 etiqueta
- 3.0.4.38 etiqueta-versión-prefijo
- 3.0.5 Redes
- 3.0.6 Registro
El Administrador de paquetes de Node, o npm , es una de las mejores partes de Node, en mi opinión. La administración de paquetes realmente puede hacer o deshacer un idioma, por lo que garantizar que sea fácil de usar y flexible es extremadamente importante.
A lo largo de mi uso de Node, solo conocía los comandos npm básicos como save
, install
y publish
, e incluso entonces realmente no conocía los parámetros opcionales que los acompañaban. Después de leer recientemente parte de la documentación de ayuda, pensé que sería útil escribir detalles sobre tantas configuraciones de npm como fuera posible. No solo creo que esto podría ser útil para los lectores, sino que también fue extremadamente útil para mí revisar todos los diferentes indicadores / parámetros y probarlos. Terminé aprendiendo mucho sobre npm que me ayudarán mucho en el futuro.
En su mayor parte, intenté escribir una descripción única de cada parámetro (diferente de los documentos de ayuda). Con suerte, de esa manera, si los documentos de ayuda lo confunden (o no tienen suficiente información), mi descripción le dará más información sobre lo que esté buscando. También agregaré ejemplos de algunos de los parámetros más confusos, así que si sabes cómo usar algunas de las opciones más indocumentadas searchopts
, me encantaría ver un ejemplo.
Configuración de parámetros
A menos que se indique lo contrario, todos los parámetros a continuación se pueden configurar a través de algunos métodos diferentes, cada uno de los cuales describiré brevemente aquí. Dependiendo de su caso de uso, utilice los diferentes propósitos para cosas como pruebas, configuración específica del proyecto, configuración global, etc.
Archivos npmrc
npm le permite usar algunos archivos rc diferentes , muy parecido ~/.bashrc
, para establecer sus configuraciones. Las cuatro ubicaciones donde pueden residir los archivos son:
- Archivo de configuración por proyecto:
/path/to/my/project/.npmrc
- Archivo de configuración por usuario:
~/.npmrc
- Archivo de configuración global:
$PREFIX/npmrc
- Archivo de configuración npm incorporado:
/path/to/npm/npmrc
https-proxy=proxy.example.com
init-license=MIT
init-author-url=http://Pharos.sh.com
color=true
El archivo que utilice debería depender del parámetro y el alcance que desee establecer. Entonces, por ejemplo, probablemente desee establecer https-proxy
en el archivo npmrc global en lugar del archivo npmrc a nivel de proyecto, ya que todos los proyectos en el sistema necesitarán la configuración del proxy.
Variable ambiental
Hay algunas variables de entorno que npm utilizará sobre los parámetros establecidos localmente (o en un archivo npmrc). Algunos ejemplos son NODE_ENV
y HTTPS_PROXY
. También puede configurar cualquier parámetro npm prefijando una variable de entorno con npm_config_
. De esa manera puedes hacer cosas como export npm_config_registry=localhost:1234
.
Mucha gente está acostumbrada a usar variables de entorno para la configuración, por lo que esto debería resultarles familiar. Por ejemplo, una excelente manera de configurar una instancia de Docker es establecer variables de entorno desde el dockerfile.
Banderas en la línea de comandos
No todos los parámetros deben configurarse permanentemente en un archivo o variable de entorno. Muchos de ellos se pueden usar dentro de un comando npm como una bandera, con el prefijo --
.
Por ejemplo, si está instalando un paquete nuevo desde el registro y desea guardarlo en su package.json
archivo, querrá usar la --save
marca, pero puede que no siempre sea así. En algunos casos, es posible que desee usar --save-dev
o incluso --save-optional
, por lo que no tendría sentido usar npmrc.
Archivo package.json
Dentro de su package.json
archivo de proyecto también puede establecer parámetros. En este caso, se config
debe utilizar el mapa, así:
{
"name": "module-name",
"version": "10.3.1",
"config": {
"foo": "bar",
"test-param": 12
},
"dependencies": {
"express": "4.2.x",
}
}
A continuación, desde el interior de su código puede acceder a estos parámetros utilizando la process
variable global, así: process.env.npm_package_config_foo
. Observe el prefijo npm_package_config_
, que le dice a Node de dónde obtener la variable.
Nota : Esto solo funcionará cuando ejecute su proyecto a través de un script npm (es decir, no solo use node index.js
).
conjunto de configuración npm
Y, por último, siempre existe la posibilidad de configurar parámetros a través de npm config set
. Esto tendrá prioridad sobre las package.json
configuraciones. Entonces, por ejemplo, si ejecutó npm config set module-name:foo baz
desde la línea de comando (y tenía el package.json
archivo desde arriba), entonces su foo
parámetro sería en baz
lugar de bar
. El module-name
alcance garantizará que esta variable no se establezca para ningún otro proyecto.
Al igual que el método anterior, para que esto funcione, debe ejecutar el programa a través de un script npm, como npm run
.
Lista de posibles parámetros
Intenté clasificar cada parámetro lo mejor posible, pero muchos de ellos también funcionarían bien en otras categorías. Entonces, después de pensarlo un poco, simplemente coloqué cada parámetro en la categoría que tenía más sentido para el contexto.
Con suerte, lo hice lo suficientemente bien organizando esto para que pueda usarlo como referencia de referencia. ¡No dudes en avisarme si hay algún error u omisión!
Control de acceso / autorización
acceso
Esto establece el nivel de acceso al alcance de un paquete, que por defecto es restricted
. Establecer este parámetro en lo public
hace visible e instalable públicamente. Si su proyecto no tiene ámbito, entonces es público.
- Predeterminado: restringido
- Tipo: Acceso (cadena)
siempre auth
Establézcalo en verdadero si desea requerir autenticación cada vez que acceda al registro, incluso para solicitudes GET.
- Predeterminado: falso
- Tipo: booleano
ese
Este es el certificado de firma de la autoridad de certificación que se utiliza para confiar en una conexión SSL con el registro de paquetes. Para especificar el certificado, use el formato PEM y reemplace todas las líneas nuevas con el n
carácter. Entonces, por ejemplo, configurar la CA podría verse así:
ca="-----BEGIN CERTIFICATE-----nXXXXnXXXXn-----END CERTIFICATE-----"
También puede confiar en varias CA especificando una matriz de certificados, uno para cada línea:
ca[]="..."
ca[]="..."
O, si se establece ca
en nulo, se especificarán los registradores conocidos predeterminados.
- Predeterminado: el certificado npm CA
- Tipo: String, Array o nulo
cafile
Similar al ca
parámetro, le cafile
permite configurar el certificado de confianza para conectarse al registro. La diferencia aquí es que puede especificar una ruta de archivo al certificado, que puede contener uno o varios certificados.
- Predeterminado: nulo
- Tipo: camino
cierto
El cert
parámetro especifica el certificado de cliente para la autenticación con un registro. Esto se opone a los certificados ca
y anteriores cafile
en que es para la autenticación del cliente en lugar de la autenticación del registro. Si aloja su propio registro, esta podría ser una buena manera de hacerlo privado sin tener que autenticarse con un nombre de usuario y contraseña.
- Predeterminado: nulo
- Tipo: Cadena
Almacenamiento en caché
cache
Esta es la ubicación del directorio de caché de npm.
- Predeterminado: Windows:,
%AppData%npm-cache
Posix:~/.npm
- Tipo: camino
caché-bloqueo-obsoleto
El número de milisegundos antes de que los archivos de bloqueo de la carpeta de caché se consideren obsoletos.
- Predeterminado: 60000 (1 minuto)
- Teclea un número
reintentos de bloqueo de caché
Número de veces que se debe reintentar para adquirir un bloqueo en los archivos de bloqueo de la carpeta de caché.
- Predeterminado: 10
- Teclea un número
caché-bloqueo-espera
Número de milisegundos para esperar a que caduquen los archivos de bloqueo de caché.
- Predeterminado: 10000 (10 segundos)
- Teclea un número
cache-max
Este es el tiempo máximo (en segundos) en el que un elemento se almacena en caché antes de actualizarse con el registro. Entonces, si anticipa que un paquete cambiará con bastante frecuencia, entonces querrá configurarlo en un número menor.
La única vez que se purgan los paquetes en caché es cuando npm cache clean
se usa el comando (o, alternativamente, puede limpiar manualmente los paquetes para seleccionar y elegir cuáles se purgan).
- Predeterminado: Infinito
- Teclea un número
min cubierta
Al contrario del cache-max
parámetro, el cache-min
parámetro establece el tiempo mínimo (en segundos) para mantener los elementos en la caché antes de verificarlos nuevamente en el registro.
- Predeterminado: 10
- Teclea un número
General
color
El color
parámetro determina si se usa la coloración en la salida npm. Si se establece en true, npm solo imprime colores para los descriptores de archivos tty. O puede configurarlo always
para usar siempre colores.
- Predeterminado: verdadero en Posix, falso en Windows
- Tipo: booleano o «siempre»
descripción
Determina si se muestra la descripción del paquete al usar npm search
.
- Predeterminado: verdadero
- Tipo: booleano
fuerza
El uso force
hará que los distintos comandos sean más contundentes. Casi puede pensar que es un uso sudo
, donde podrá eludir ciertas restricciones. Entonces, por nombrar algunos ejemplos, usar esto significaría que una falla en el script del ciclo de vida no bloquea el progreso, la publicación sobrescribe versiones publicadas anteriormente, npm omite la caché cuando se solicita desde el registro o evitaría verificaciones contra la sobrescritura de archivos que no son npm.
- Predeterminado: falso
- Tipo: booleano
global
global
hace que un comando dado opere en el modo ‘global’. Todos los usuarios y proyectos del sistema pueden acceder a los paquetes instalados en esta carpeta. Esto significa que los paquetes se instalan en la carpeta ‘prefijo’, que normalmente es donde se instala el node. Específicamente, los paquetes globales estarán ubicados en {prefix}/lib/node_modules
, los archivos bin estarán vinculados {prefix}/bin
y las páginas de manual se vincularán {prefix}/share/man
.
- Predeterminado: falso
- Tipo: booleano
globalconfig
La ubicación del archivo de configuración para leer las opciones de configuración global.
- Predeterminado: {prefijo} / etc / npmrc
- Tipo: camino
grupo
Este parámetro le dice a npm qué grupo de sistema usar cuando se ejecutan scripts de paquetes en modo global como usuario root.
- Predeterminado: el ID de grupo del proceso actual
- Tipo: Cadena o Número
largo
Si mostrar o no información detallada al ejecutar npm ls
y npm search
.
- Predeterminado: falso
- Tipo: booleano
prefijo
Esta es la ubicación donde se instalan los elementos globales, que de forma predeterminada es la ubicación de instalación de npm. Si prefix
se establece en la línea de comando, los comandos no globales se ven obligados a ejecutarse en la carpeta dada.
- Predeterminado: ver
npm help 5 folders
- Tipo: camino
girar
El spin
parámetro determina si se muestra o no una ruleta ASCII mientras npm está esperando o procesando algo (suponiendo que process.stderr es un TTY). Esto se puede establecer en falso para suprimir la ruleta por completo, o configurarse en ‘siempre’ para generar la ruleta incluso para salidas que no sean TTY.
- Predeterminado: verdadero
- Tipo: booleano o «siempre»
tmp
El directorio donde se almacenan los archivos y directorios temporales. Una vez que el proceso npm se ha completado correctamente, se eliminan todos los archivos y directorios. Sin embargo, si el proceso falla, los archivos y directorios no se eliminan para que pueda inspeccionarlos y depurar el problema.
- Valor predeterminado: variable de entorno TMPDIR o «/ tmp»
- Tipo: camino
Unicode
El unicode
parámetro le dice a npm si usar o no caracteres unicdoe en la salida del árbol. Si false
, solo se utilizan caracteres ASCII para dibujar los árboles.
- Predeterminado: verdadero
- Tipo: booleano
permanente insegura
Cuando unsafe-perm
se establece en true
, el cambio de ID de usuario / grupo se suprime cuando se ejecuta un script de paquete. Si false
, los usuarios que no sean root no podrán instalar paquetes.
- Predeterminado: falso si se ejecuta como root, verdadero en caso contrario
- Tipo: booleano
uso
El uso de la usage
bandera reduce la cantidad de salida al obtener ayuda para un comando. En lugar de mostrarle todos los indicadores / entradas posibles a un comando, como lo -H
haría el indicador, solo le brinda la esencia de la documentación de ayuda. Entonces, por ejemplo, la ejecución npm --usage search
daría como resultado npm search [some search terms ...]
.
- Predeterminado: falso
- Tipo: booleano
usuario
Este es el UID que se debe usar cuando se ejecuta un script de paquete como root. Entonces, si no desea que el script tenga permisos de root, establezca esto en el UID del usuario que tiene el nivel de permiso y acceso correctos para la aplicación. ¡Ejecutar un script de paquete como root puede ser peligroso!
- Predeterminado: «nadie»
- Tipo: Cadena o Número
userconfig
Esta es la ubicación de un archivo de configuración a nivel de usuario. Cada usuario de un sistema puede tener diferentes configuraciones para la instalación de npm, y el archivo debe ubicarse en la ruta indicada en userconfig
.
- Predeterminado: ~ / .npmrc
- Tipo: camino
umask
Este es el valor de máscara que se debe usar al configurar el modo de creación de archivos para archivos y directorios. El tipo de archivo / directorio que se crea depende del valor de máscara utilizado. Si es un directorio o un ejecutable, entonces el umask
valor está enmascarado 0777
. Para todos los demás archivos, el umask
valor está enmascarado 0666
. Los valores predeterminados son 0755
y 0644
respectivamente, que es una máscara bastante conservadora para cada tipo de archivo.
- Por defecto: 022
- Tipo: cadena numérica octal en el rango 0000..0777 (0..511)
versión
El uso de esta bandera genera la versión de npm instalada. Esto sólo funciona cuando se utiliza en la línea de comandos como una bandera como npm --version
.
- Predeterminado: falso
- Tipo: booleano
versiones
El uso de esta marca es similar a version
, pero genera detalles de la versión (como JSON) en algunos paquetes diferentes, incluido el proyecto en el directorio actual (si está presente), V8, npm y detalles de process.versions
. Esto sólo funciona cuando se utiliza en la línea de comandos como una bandera como npm --versions
.
Un resultado de ejemplo podría verse así:
{ 'my-project': '0.0.1',
npm: '2.14.2',
http_parser: '2.3',
modules: '14',
node: '0.12.2',
openssl: '1.0.1m',
uv: '1.4.2-node1',
v8: '3.28.73',
zlib: '1.2.8' }
- Predeterminado: falso
- Tipo: booleano
espectador
Este es el programa que se utilizará al visualizar el contenido de ayuda. Si se establece en ‘navegador’, el navegador web predeterminado se abrirá y mostrará el contenido de ayuda en HTML.
- Por defecto: «man» en Posix, «navegador» en Windows
- Tipo: ruta, ‘hombre’ o ‘navegador’
Desarrollo
dev
El uso de esta marca al instalar paquetes también instalará los paquetes dev-dependencies. Esto casi siempre debe usarse cuando no se está ejecutando un proyecto en producción.
Esto es similar a la npat
bandera.
- Predeterminado: falso
- Tipo: booleano
editor
Este es el comando (o ruta a un ejecutable) que se ejecutará al abrir un editor.
- Predeterminado: variable de entorno EDITOR si está configurada, o «vi» en Posix, o «bloc de notas» en Windows.
- Tipo: camino
motor-estricto
Este parámetro le dice a npm si debe seguir package.json
estrictamente la especificación del motor en un archivo. Si se establece en true
, la instalación de un paquete fallará si la versión actual de Node.js no coincide con la especificada.
Esto es útil cuando un paquete requiere una determinada versión de Node.js, o incluso io.js (posiblemente porque el paquete usa características de ES6).
- Predeterminado: falso
- Tipo: booleano
Vamos
Este debería ser el comando a usar para ejecutar comandos git. Esto podría ser útil cuando git está instalado, pero no está en la RUTA, en cuyo caso especificaría la ruta de la instalación de git.
- Predeterminado: «git»
- Tipo: Cadena
git-tag-version
Esto le dice a npm si debe etiquetar la confirmación al ejecutar el npm version
comando (lo que aumenta la versión del paquete y lo guarda en package.json
). Esto puede ayudar a reducir errores (olvidar etiquetar el git commit, etiquetarlo como la versión incorrecta, etc.), pero también le da menos control, por lo que tendrá que sopesar las compensaciones.
- Predeterminado: verdadero
- Tipo: booleano
Bóveda
La cadena que se imprimirá al generar información de depuración.
- Predeterminado: «npm»
- Tipo: Cadena
si está presente
Al usar el npm run-script
comando, si el script no está definido en el package.json
archivo, npm sale con un código de error. Si if-present
se establece en true
, no se devuelve el código de error. Esto es útil cuando, opcionalmente, desea ejecutar un script, pero no le importa si no está presente. Entonces, por ejemplo, tal vez tenga un script (script A
) que esté presente en algunos de sus proyectos, pero no en todos, y use otro script genérico (script B
) para ejecutarlo. De esta manera, si la secuencia de comandos A
no está presente, la secuencia de comandos B
no recibirá un error y podrá seguir ejecutándose de manera segura.
- Predeterminado: falso
- Tipo: booleano
ignorar guiones
Configure este indicador para no ejecutar ningún script definido en el package.json
archivo de un proyecto.
- Predeterminado: falso
- Tipo: booleano
módulo de inicio
Esta es la ruta a un archivo JavaScript que ayuda a inicializar un proyecto. Entonces, si tiene una configuración personalizada que desea que tengan todos sus nuevos proyectos (como tal vez una dependencia en Bluebird o un motor predeterminado), entonces puede crear un archivo en la ubicación especificada para manejar la inicialización por usted.
- Predeterminado: ~ / .npm-init.js
- Tipo: camino
nombre-autor-init
El nombre predeterminado utilizado por npm init
al crear un nuevo proyecto.
- Defecto: «»
- Tipo: Cadena
El correo electrónico de autor predeterminado utilizado por npm init
al crear un nuevo proyecto.
- Defecto: «»
- Tipo: Cadena
La URL de autor predeterminada utilizada por npm init
al crear un nuevo proyecto.
- Defecto: «»
- Tipo: Cadena
init-licencia
La licencia predeterminada utilizada por npm init
al crear un nuevo proyecto.
- Predeterminado: «ISC»
- Tipo: Cadena
init-version
La versión predeterminada utilizada por npm init
al crear un nuevo proyecto.
- Predeterminado: «1.0.0»
- Tipo: Cadena
json
Este parámetro determina si npm escribe o no su salida como json o texto normal.
NOTA : npm afirma que esta función es experimental y que la estructura de los objetos JSON está sujeta a cambios.
- Predeterminado: falso
- Tipo: booleano
enlace
Si link
se establece en verdadero, las instalaciones locales se vincularán a las instalaciones del paquete global (si hay un paquete coincidente). Un subproducto importante de estas características es que al vincular a paquetes globales, las instalaciones locales pueden hacer que se instalen otras cosas en el espacio global.
Los enlaces se crean si se cumple al menos una de las dos condiciones:
Te puede interesar:Cómo crear plugins C / C ++ en el node- El paquete aún no está instalado globalmente
- la versión instalada globalmente es idéntica a la versión que se está instalando localmente
- Predeterminado: falso
- Tipo: booleano
dirección local
Esta es la dirección IP de la interfaz de red local del sistema que se utilizará al conectarse al registro npm.
NOTA : Debe ser una dirección IPv4 en el node v0.12 y versiones anteriores.
- Predeterminado: indefinido
- Tipo: dirección IP
nivel de registro
Este es el nivel de registro predeterminado para cuando se ejecuta su aplicación. Si hay un evento de registro superior (o igual a) que el que se proporciona aquí, se envía al usuario. Cuando / si la aplicación falla, todos los registros se escriben npm-debug.log
en el directorio de trabajo actual.
- Predeterminado: «advertir»
- Tipo: Cadena
corriente de registro
La secuencia que usa el npmlog
paquete en tiempo de ejecución.
NOTA : Esto no se puede configurar en la línea de comando. Debe utilizar otro método, como un archivo o una variable de entorno para configurarlo.
- Predeterminado: process.stderr
- Tipo: corriente
mensaje
Este es el mensaje de confirmación que utilizará el npm version
comando. El carácter de formato ‘% s’ será reemplazado por el número de versión.
- Predeterminado: «% s»
- Tipo: Cadena
versión de node
La versión de node utilizada al verificar la engines
declaración de un paquete en el package.json
archivo.
- Por defecto: process.version
- Tipo: semver o falso
npat
Si ejecutar o no las pruebas de un paquete en la instalación.
- Predeterminado: falso
- Tipo: booleano
onload-script
Esta es la ubicación de un paquete para requre()
una vez que se carga npm. Se recomienda para el uso programático de npm.
- Predeterminado: falso
- Tipo: ruta o ‘falso’
Opcional
Esto le dice a npm que instale los paquetes del optionalDependencies
mapa en el package.json
archivo. Dado que estas son dependencias opcionales, si una no se instala, npm no abortará el proceso.
- Predeterminado: verdadero
- Tipo: booleano
analizable
El parseable
parámetro le dice a npm que formatee su salida en un formato analizable al escribir en la salida estándar.
- Predeterminado: falso
- Tipo: booleano
producción
Cuando se establece en true
, npm se ejecuta en modo de producción, lo que generalmente significa que devDependencies
no están instalados. Tenga en cuenta que debe usar NODE_ENV="production"
la variable de entorno en su lugar cuando use scripts de ciclo de vida.
- Predeterminado: falso
- Tipo: booleano
Retroceder
El uso de esta bandera con npm eliminará cualquier paquete que no se haya podido instalar (tal vez debido a un error de compilación / dependencia, por ejemplo).
- Predeterminado: verdadero
- Tipo: booleano
salvar
El uso de esta bandera con npm guarda el paquete dado en el package.json
archivo local bajo dependencies
. Alternativamente, usar esta bandera con el npm rm
comando eliminará una dependencia de la dependencies
sección del package.json
archivo.
Tenga en cuenta que esto solo funciona cuando hay un package.json
archivo en el directorio actual.
- Predeterminado: falso
- Tipo: booleano
guardar-paquete
Si un paquete se guarda en el momento de la instalación mediante el uso de los --save
, --save-dev
o --save-optional
banderas, entonces también lo puso en la bundleDependencies
lista. Cuando se usa con el npm rm
comando, lo elimina de la bundledDependencies
lista.
- Predeterminado: falso
- Tipo: booleano
save-dev
El uso de esta bandera guarda los paquetes en la devDependencies
lista del package.json
archivo. Lo contrario es cierto cuando se usa con npm rm
, lo que significa que el paquete se eliminará devDependencies
. Al igual que la save
bandera, esto solo funciona si hay un package.json
archivo presente.
- Predeterminado: falso
- Tipo: booleano
guardar-exacto
Cuando una dependencia se guarda en el package.json
archivo usando uno de los indicadores --save
, --save-dev
o --save-optional
, entonces se configurará usando el número de versión exacto en lugar del operador de rango semver predeterminado de npm.
- Predeterminado: falso
- Tipo: booleano
guardar-opcional
El uso de esta bandera guarda los paquetes en la optionalDependencies
lista del package.json
archivo. Lo contrario es cierto cuando se usa con npm rm
, lo que significa que el paquete se eliminará optionalDependencies
. Al igual que la save
bandera, esto solo funciona si hay un package.json
archivo presente.
- Predeterminado: falso
- Tipo: booleano
guardar-prefijo
Este parámetro determina cómo se guardan los paquetes package.json
si se usan con las banderas --save
o --save-dev
. Usando el valor predeterminado como ejemplo, si guardamos un paquete con la versión 1.2.3
, en realidad se guardará package.json
como ^1.2.3
.
- Predeterminado: ‘^’
- Tipo: Cadena
alcance
El uso scope
le dice a npm qué alcance usar para un registro con alcance. Esto puede resultar útil al utilizar un registro privado por primera vez. Ejemplo:
npm login [email protected] --registry=registry.example.com
Esto hace @organization
que se asigne a este registro para futuras instalaciones de paquetes especificados de acuerdo con el patrón @organization/package
.
- Defecto: «»
- Tipo: Cadena
Envoltura retráctil
Cuando false
, el npm-shrinkwrap.json
archivo se ignora durante la instalación.
- Predeterminado: verdadero
- Tipo: booleano
sign-git-tag
Al ejecutar el npm version
comando y usar esta bandera, la -s
bandera se usará durante el etiquetado para agregar una firma. Para que esto funcione, debe haber configurado claves GPG en sus configuraciones de git.
- Predeterminado: falso
- Tipo: booleano
etiqueta
Al instalar un paquete de npm y no especificar la versión, se utilizará esta etiqueta en su lugar.
- Predeterminado: último
- Tipo: Cadena
etiqueta-versión-prefijo
El carácter que se antepone a la versión del paquete cuando se usa npmversion
. Esto es útil cuando otros programas tienen una convención de estilo para las versiones.
- Predeterminado: «v»
- Tipo: Cadena
Redes
https-proxy
El proxy utilizado para las conexiones HTTPS salientes. Si alguna de las siguientes variables de entorno se establecen, a continuación, se utilizan en su lugar: HTTPS_PROXY
, https_proxy
, HTTP_PROXY
, http_proxy
.
- Predeterminado: nulo
- Tipo: URL
apoderado
El proxy utilizado para las conexiones HTTP salientes. Si se establece alguna de las siguientes variables de entorno, se utilizan en su lugar: HTTP_PROXY
, http_proxy
.
- Predeterminado: nulo
- Tipo: URL
estricto-ssl
Esto le dice a npm si debe usar SSL para conectarse con el registro a través de HTTPS.
- Predeterminado: verdadero
- Tipo: booleano
agente de usuario
Establece el encabezado de solicitud de agente de usuario para solicitudes HTTP (S).
- Predeterminado: node / {process.version} {process.platform} {process.arch}
- Tipo: Cadena
Registro
recuperar-reintentos
La cantidad de veces que npm intenta comunicarse con el registro para obtener un paquete.
- Por defecto: 2
- Teclea un número
factor de recuperación de reintento
La configuración de «factor» para que el módulo de reintento lo utilice al recuperar paquetes.
- Predeterminado: 10
- Teclea un número
fetch-retry-mintimeout
El tiempo mínimo de espera antes de que se agote el tiempo de espera al recuperar paquetes del registro.
- Predeterminado: 10000 (10 segundos)
- Tipo: Número (milisegundos)
fetch-retry-maxtimeout
El tiempo máximo de espera antes de que se agote el tiempo de espera al recuperar paquetes del registro.
- Predeterminado: 10000 (10 segundos)
- Tipo: Número (milisegundos)
llave
Esta es la clave de cliente que se debe utilizar al autenticarse con el registro.
Te puede interesar:Introducción a AWS Lambda y Node.js- Predeterminado: nulo
- Tipo: Cadena
registro
La URL del registro que se utilizará para obtener y publicar paquetes.
- Predeterminado: https://registry.npmjs.org/
- Tipo: URL
búsquedas
Una lista de opciones separadas por espacios que siempre se utilizan para buscar en el registro.
- Defecto: «»
- Tipo: Cadena
buscar excluir
Una lista de límites separados por espacios que siempre se utilizan para buscar en el registro.
- Defecto: «»
- Tipo: Cadena
buscar
Esto indica en qué campo de los resultados se debe ordenar. Para invertir el orden de clasificación, simplemente antepóngalo con un -
.
- Predeterminado: «nombre»
- Tipo: Cadena
- Valores: «nombre», «-nombre», «fecha», «-fecha», «descripción», «-descripción», «palabras clave», «-palabras clave»