La guía definitiva para configurar NPM

En mi opinión, Node Package Manager, o npm, es una de las mejores partes de Node. La gestión de paquetes realmente puede hacer o deshacer un idioma, así que asegúrese de que...

Introducción

En mi opinión, Node Package Manager, o npm, es una de las mejores partes de Node. La gestión de paquetes realmente puede hacer o deshacer un idioma, por lo que es extremadamente importante asegurarse de que sea fácil de usar y flexible.

A lo largo de mi uso de Node, solo conocía los comandos básicos de npm como “guardar”, “instalar” y “publicar”, e incluso entonces no sabía realmente los parámetros opcionales que los acompañaban. Después de leer parte de la documentación de ayuda recientemente, pensé que sería útil escribir detalles sobre la mayor cantidad posible de configuraciones de npm. No solo creo que esto podría ser útil para los lectores, sino que fue extremadamente útil para mí revisar todas las diferentes banderas/parámetros y probarlos. Terminé aprendiendo mucho sobre npm que me ayudará mucho en el futuro.

En su mayor parte, traté de 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 tiene 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 sabe cómo usar algunas de las opciones menos documentadas, como 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 {#archivos npmrc}

npm le permite usar algunos archivos rc diferentes, como ~/.bashrc, para establecer sus configuraciones. Las cuatro ubicaciones donde pueden residir los archivos son:

  • Archivo de configuración por proyecto: /ruta/a/mi/proyecto/.npmrc
  • Archivo de configuración por usuario: ~/.npmrc
  • Archivo de configuración global: $PREFIX/npmrc
  • Archivo de configuración de npm integrado: /ruta/a/npm/npmrc
1
2
3
4
https-proxy=proxy.example.com
init-license=MIT
init-author-url=https://wikihtp.com
color=true

El archivo que use debe depender del parámetro y el alcance que desea configurar. Entonces, por ejemplo, probablemente desee configurar 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 de entorno {#variable de entorno}

Hay algunas variables de entorno que npm usará sobre los parámetros establecidos localmente (o en un archivo npmrc). Algunos ejemplos son NODE_ENV y HTTPS_PROXY. También puede establecer cualquier parámetro npm anteponiendo una variable de entorno con npm_config_. De esa manera, puede hacer cosas como exportar npm_config_registry=localhost:1234.

Muchas personas están acostumbradas 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 Estibador es establecer variables de entorno desde el dockerfile.

Indicadores en la línea de comandos

No todos los parámetros deben establecerse de forma permanente en un archivo o variable de entorno. Muchos de ellos se pueden usar dentro de un comando npm como un indicador, con el prefijo --.

Por ejemplo, si está instalando un nuevo paquete desde el registro y desea guardarlo en su archivo package.json, querrá usar el indicador --save, pero es posible que no siempre sea así. el caso. En algunos casos, es posible que desee usar --save-dev o incluso --save-opcional, por lo que no tendría sentido usar npmrc.

archivo paquete.json

Dentro de su archivo de proyecto package.json también puede establecer parámetros. En este caso, se debe usar el mapa config, así:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
  "name": "module-name",
  "version": "10.3.1",
  "config": {
    "foo": "bar",
    "test-param": 12
  },
  "dependencies": {
    "express": "4.2.x",
  }
}

Luego, desde su código, puede acceder a estos parámetros usando la variable global process, 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 usando node index.js).

conjunto de configuración npm

Y, por último, siempre existe la posibilidad de establecer parámetros a través de npm config set. Esto tendrá prioridad sobre las configuraciones package.json. Entonces, por ejemplo, si ejecutó npm config set module-name:foo baz desde la línea de comando (y tenía el archivo package.json de arriba), entonces su parámetro foo sería baz en lugar de barra. El alcance de module-name asegurará 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

Traté de categorizar cada parámetro lo mejor posible, pero muchos de ellos también funcionarían bien en otras categorías. Entonces, después de contemplar un poco, puse cada parámetro en la categoría que tenía más sentido para el contexto.

Espero haber organizado esto lo suficientemente bien para que puedas usarlo como referencia. ¡No dude en hacerme saber 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 restringido. Establecer este parámetro en público lo hace públicamente visible e instalable. Si su proyecto no tiene alcance, entonces es público.

  • Predeterminado: restringido
  • Tipo: Acceso (cadena)
autenticación siempre {#autenticación siempre}

Establézcalo en verdadero si desea solicitar autenticación cada vez que acceda al registro, incluso para solicitudes GET.

  • Predeterminado: falso
  • Tipo: Booleano
ca

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 del paquete. Para especificar el certificado, use el formato PEM y reemplace todas las líneas nuevas con el carácter \n. Entonces, por ejemplo, establecer la CA podría verse así:

ca="-----COMENZAR CERTIFICADO-----\nXXXX\nXXXX\n-----FIN DE CERTIFICADO-----"

También puede confiar en varias CA especificando una serie de certificados, uno para cada línea:

1
2
ca[]="..."
ca[]="..."

O bien, establecer ca en nulo especificará los registradores conocidos predeterminados.

  • Predeterminado: el certificado de CA npm
  • Tipo: Cadena, Array o nulo
café

Similar al parámetro ca, cafile le 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
certificado

El parámetro cert especifica el certificado de cliente para la autenticación con un registro. Esto se opone a los certificados ca y cafile anteriores 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: Cuerda

Almacenamiento en caché

caché

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é {#reintentos de bloqueo de caché}

Número de veces para volver a intentar 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 de espera para que caduquen los archivos de bloqueo de caché.

  • Predeterminado: 10000 (10 segundos)
  • Teclea un número
caché-máximo

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á establecer esto en un número más bajo.

La única vez que se purgan los paquetes almacenados en caché es cuando se usa el comando npm cache clean (o, alternativamente, puede limpiar manualmente los paquetes para elegir cuáles se purgan).

  • Predeterminado: Infinito
  • Teclea un número
caché-min

Al contrario del parámetro cache-max, el parámetro cache-min establece el tiempo mínimo (en segundos) para mantener los elementos en el caché antes de volver a verificarlos en el registro.

  • Predeterminado: 10
  • Teclea un número

General

color

El parámetro color determina si se utiliza la coloración en la salida npm. Si se establece en verdadero, npm solo imprime colores para los descriptores de archivos tty. O puede establecerlo en siempre para usar siempre colores.

  • Predeterminado: verdadero en Posix, falso en Windows
  • Tipo: Booleano o "siempre"
descripción

Determina si la descripción del paquete se muestra cuando se usa npm search.

  • Predeterminado: verdadero
  • Tipo: Booleano
fuerza

El uso de force hará que los diversos comandos sean más contundentes. Casi puede pensar en ello como si usara sudo, donde podrá eludir ciertas restricciones. Entonces, para nombrar algunos ejemplos, usar esto significaría que una falla del script de ciclo de vida no bloquea el progreso, la publicación sobrescribe las versiones publicadas anteriormente, npm omite el caché cuando se solicita desde el registro, o evitaría las comprobaciones contra la sobrescritura de archivos que no son npm.

  • Predeterminado: falso
  • Tipo: Booleano
global

global hace que un comando determinado funcione 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 'prefix', que normalmente es donde se instala el nodo. Específicamente, los paquetes globales se ubicarán en {prefix}/lib/node_modules, los archivos bin se vincularán a {prefix}/bin y las páginas man se vincularán a {prefix}/share/man .

  • Predeterminado: falso
  • Tipo: Booleano
configuración global

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 debe usar al ejecutar scripts de paquetes en modo global como usuario raíz.

  • Predeterminado: el ID de grupo del proceso actual
  • Tipo: Cadena o Número
largo

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 se establece prefijo en la línea de comandos, los comandos no globales se verán obligados a ejecutarse en la carpeta dada.

  • Predeterminado: ver npm help 5 carpetas
  • Tipo: camino
girar

El parámetro spin determina si se muestra o no una rueda ASCII mientras npm está esperando o procesando algo (suponiendo que process.stderr es un TTY). Esto se puede establecer en falso para suprimir la rueda giratoria por completo, o se puede establecer en 'siempre' para generar la rueda giratoria 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 haya completado con éxito, se eliminarán todos los archivos y directorios. Sin embargo, si el proceso falla, los archivos y directorios no se eliminan para que pueda inspeccionarlos y solucionar el problema.

  • Valor predeterminado: variable de entorno TMPDIR o "/tmp"
  • Tipo: camino
código único

El parámetro unicode le dice a npm si usar o no caracteres unicdoe en la salida del árbol. Si es falso, solo se utilizan caracteres ASCII para dibujar los árboles.

  • Predeterminado: verdadero
  • Tipo: Booleano
unsafe-perm

Cuando unsafe-perm se establece en true, el cambio de ID de usuario/grupo se suprime cuando se ejecuta un script de paquete. Si es falso, los usuarios no root no podrán instalar paquetes.

  • Predeterminado: falso si se ejecuta como root, verdadero de lo contrario
  • Tipo: Booleano
uso

El uso de la bandera uso reduce la cantidad de salida cuando se obtiene ayuda para un comando. En lugar de mostrarte todos los indicadores/entradas posibles para un comando, como lo haría el indicador -H, solo te brinda la esencia de la documentación de ayuda. Entonces, por ejemplo, ejecutar npm --usage search generaría npm search [algunos términos de búsqueda...].

  • Predeterminado: falso
  • Tipo: Booleano
usuario

Este es el UID que se utilizará cuando se ejecute un script de paquete como root. Entonces, si no desea que la secuencia de comandos tenga permisos de raíz, 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
configuración de usuario

Esta es la ubicación de un archivo de configuración a nivel de usuario. Cada usuario en un sistema puede tener diferentes configuraciones para la instalación de npm, y el archivo debe ubicarse en la ruta proporcionada en userconfig.

  • Predeterminado: ~/.npmrc
  • Tipo: camino
máscara

Este es el valor de máscara que se debe usar al establecer 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 valor umask está enmascarado contra 0777. Para todos los demás archivos, el valor umask está enmascarado frente a 0666. Los valores predeterminados son 0755 y 0644 respectivamente, que es una máscara bastante conservadora para cada tipo de archivo.

  • Predeterminado: 022
  • Tipo: Cadena numérica octal en el rango 0000..0777 (0..511)
versión

El uso de este indicador genera la versión de npm instalada. Esto solo funciona cuando se usa en la línea de comando como un indicador como npm --version.

  • Predeterminado: falso
  • Tipo: booleano
versiones

El uso de este indicador es similar a versión, 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 solo funciona cuando se usa en la línea de comando como un indicador como npm --versions.

Una salida de ejemplo podría verse así:

1
2
3
4
5
6
7
8
9
{ '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 ver el contenido de ayuda. Si se establece en 'navegador', el navegador web predeterminado se abrirá y mostrará el contenido de ayuda en HTML.

  • Predeterminado: "hombre" en Posix, "navegador" en Windows
  • Tipo: ruta, 'hombre' o 'navegador'

Desarrollo

desarrollador

El uso de este indicador al instalar paquetes también instalará los paquetes de dependencias de desarrollo. Esto casi siempre debe usarse cuando no se está ejecutando un proyecto en producción.

Esto es similar a la bandera npat.

  • Predeterminado: falso
  • Tipo: Booleano
editor

Este es el comando (o la ruta a un ejecutable) que se ejecutará al abrir un editor.

  • Valor predeterminado: variable de entorno EDITOR si está configurada, o "vi" en Posix, o "notepad" en Windows.
  • Tipo: camino
motor-estricto

Este parámetro le dice a npm si debe seguir estrictamente la especificación del motor en un archivo package.json. 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
git

Este debería ser el comando a usar para ejecutar los comandos de git. Esto podría ser útil cuando se instala git, pero no está en la RUTA, en cuyo caso debe especificar la ruta de la instalación de git.

  • Predeterminado: "git"
  • Tipo: Cuerda
versión de la etiqueta de git {#versión de la etiqueta de git}

Esto le dice a npm si debe etiquetar la confirmación al ejecutar el comando npm version (que supera la versión del paquete y la guarda en package.json). Esto puede ayudar a reducir los errores (olvidarse de etiquetar el compromiso de git, 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: Cuerda
si está presente {#si está presente}

Al usar el comando npm run-script, si el script no está definido en el archivo package.json, entonces 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 forma, si el script A no está presente, entonces el script B no obtendrá un error y podrá seguir ejecutándose de forma segura.

  • Predeterminado: falso
  • Tipo: Booleano
ignorar-scripts

Configure este indicador para que no ejecute ningún script definido en el archivo package.json de un proyecto.

  • Predeterminado: falso
  • Tipo: Booleano
módulo de inicio {#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 una dependencia de Azulejo 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: Cuerda
init-author-email

El correo electrónico predeterminado del autor utilizado por npm init al crear un nuevo proyecto.

  • Defecto: ""
  • Tipo: Cuerda
init-autor-url

La URL de autor predeterminada utilizada por npm init al crear un nuevo proyecto.

  • Defecto: ""
  • Tipo: Cuerda
licencia de inicio {#licencia de inicio}

La licencia predeterminada utilizada por npm init al crear un nuevo proyecto.

  • Predeterminado: "ISC"
  • Tipo: Cuerda
versión de inicio {#versión de inicio}

La versión predeterminada utilizada por npm init al crear un nuevo proyecto.

  • Predeterminado: "1.0.0"
  • Tipo: Cuerda
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 enlace 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 vincularse 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:

  • 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 usará al conectarse al registro npm.

NOTA: Esta debe ser una dirección IPv4 en Node v0.12 y anterior.

  • 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 mayor (o igual) que el que se proporciona aquí, se envía al usuario. Cuando/si la aplicación falla, todos los registros se escriben en npm-debug.log en el directorio de trabajo actual.

  • Predeterminado: "advertir"
  • Tipo: Cuerda
flujo de registro

El flujo utilizado por el paquete npmlog en tiempo de ejecución.

NOTA: Esto no se puede configurar en la línea de comando. Debe usar otro método, como un archivo o una variable de entorno para configurarlo.

  • Predeterminado: proceso.stderr
  • Tipo: Corriente
mensaje

Este es el mensaje de confirmación que utilizará el comando npm version. El carácter de formato '%s' será reemplazado por el número de versión.

  • Predeterminado: "%s"
  • Tipo: Cuerda
versión de nodo {#versión de nodo}

La versión de nodo utilizada al comprobar la declaración motores de un paquete en el archivo package.json.

  • Predeterminado: proceso.versión
  • Tipo: semver o false
npat

Si ejecutar o no las pruebas de un paquete en la instalación.

  • Predeterminado: falso
  • Tipo: Booleano
script de carga {#script de carga}

Esta es la ubicación de un paquete para requre() una vez que se carga npm. Esto 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 desde el mapa de dependencias opcionales en el archivo paquete.json. Dado que estas son dependencias opcionales, si una falla al instalar, npm no cancelará el proceso.

  • Predeterminado: verdadero
  • Tipo: Booleano
analizable

El parámetro parseable le dice a npm que formatee su salida en un formato analizable cuando escriba 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 en su mayoría significa que las devDependencies no están instaladas. Tenga en cuenta que debe usar la variable de entorno NODE_ENV="production" en su lugar cuando use secuencias de comandos de ciclo de vida.

  • Predeterminado: falso
  • Tipo: Booleano
Retroceder

El uso de este indicador 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
ahorrar

El uso de este indicador con npm guarda el paquete dado en el archivo package.json local bajo dependencias. Alternativamente, usar este indicador con el comando npm rm eliminará una dependencia de la sección dependencies del archivo package.json.

Tenga en cuenta que esto solo funciona cuando hay un archivo package.json en el directorio actual.

  • Predeterminado: falso
  • Tipo: Booleano
paquete guardado {#paquete guardado}

Si un paquete se guarda en el momento de la instalación usando las banderas --save, --save-dev o --save-opcional, también colóquelo en la lista bundleDependencies. Cuando se usa con el comando npm rm, lo elimina de la lista bundledDependencies.

  • Predeterminado: falso
  • Tipo: Booleano
guardar-dev

El uso de este indicador guarda los paquetes en la lista devDependencies en el archivo package.json. Lo contrario es cierto cuando se usa con npm rm, lo que significa que el paquete se eliminará de devDependencies. Al igual que el indicador save, esto solo funciona si hay un archivo package.json presente.

  • Predeterminado: falso
  • Tipo: Booleano
guardar-exacto

Cuando se guarda una dependencia en el archivo package.json usando uno de los indicadores --save, --save-dev o --save-opcional, entonces se configurará usando el número de versión exacto en lugar del operador de rango de semver predeterminado de npm.

  • Predeterminado: falso
  • Tipo: Booleano
guardar opcional {# guardar opcional}

El uso de este indicador guarda los paquetes en la lista de dependencias opcionales en el archivo package.json. Lo contrario es cierto cuando se usa con npm rm, lo que significa que el paquete se eliminará de opcionalDependencias. Al igual que el indicador save, esto solo funciona si hay un archivo package.json presente.

  • Predeterminado: falso
  • Tipo: Booleano
guardar-prefijo

Este parámetro determina cómo se guardan los paquetes en 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á en package.json como ^1.2.3.

  • Predeterminado: '^'
  • Tipo: Cuerda
alcance

El uso de alcance le dice a npm qué alcance usar para un registro con alcance. Esto podría ser útil cuando se utiliza un registro privado por primera vez. Ejemplo:

npm login [correo electrónico protegido] --registry=registry.example.com

Esto hace que @organization se asigne a este registro para futuras instalaciones de paquetes especificados de acuerdo con el patrón @organization/package.

  • Defecto: ""
  • Tipo: Cuerda
Envoltura retráctil

Cuando es falso, el archivo npm-shrinkwrap.json se ignora durante la instalación.

  • Predeterminado: verdadero
  • Tipo: Booleano
sign-git-tag

Al ejecutar el comando npm version y usar este indicador, el indicador -s se usará durante el etiquetado para agregar una firma. Para que esto funcione, ya debe haber configurado las claves GPG en sus configuraciones de git.

  • Predeterminado: falso
  • Tipo: Booleano
etiqueta

Al instalar un paquete desde npm y no especificar la versión, se usará esta etiqueta en su lugar.

  • Predeterminado: último
  • Tipo: Cuerda
prefijo de versión de etiqueta {#prefijo de versión de etiqueta}

El carácter antepuesto 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: Cuerda

Redes

https-proxy

El proxy utilizado para las conexiones HTTPS salientes. Si se establece alguna de las siguientes variables de entorno, 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
SSL estricto

Esto le dice a npm si usar o no SSL para conectarse con el registro a través de HTTPS.

  • Predeterminado: verdadero
  • Tipo: Booleano
usuario-agente

Establece el encabezado de solicitud de agente de usuario para solicitudes HTTP(S).

  • Predeterminado: nodo/{proceso.versión} {proceso.plataforma} {proceso.arquitectura}
  • Tipo: Cuerda

Registro

reintentos de búsqueda {#reintentos de búsqueda}

La cantidad de veces que npm intenta comunicarse con el registro para obtener un paquete.

  • Predeterminado: 2
  • Teclea un número
factor de reintento de búsqueda {#factor de reintento de búsqueda}

La configuración de "factor" para que el módulo de reintento la use al buscar paquetes.

  • Predeterminado: 10
  • Teclea un número
buscar-reintentar-mintimeout

El tiempo mínimo de espera antes de que se agote el tiempo de espera al obtener paquetes del registro.

  • Predeterminado: 10000 (10 segundos)
  • Tipo: Número (milisegundos)
buscar-reintentar-maxtimeout

El tiempo máximo de espera antes de que se agote el tiempo de espera al obtener paquetes del registro.

  • Predeterminado: 10000 (10 segundos)
  • Tipo: Número (milisegundos)
llave

Esta es la clave de cliente que se utilizará al autenticarse con el registro.

  • Predeterminado: nulo
  • Tipo: Cuerda
registro

La URL del registro que se usará para obtener y publicar paquetes.

opciones de búsqueda

Una lista de opciones separadas por espacios que siempre se utilizan para buscar en el registro.

  • Defecto: ""
  • Tipo: Cuerda
buscarexcluir

Una lista de límites separados por espacios que siempre se utilizan para buscar en el registro.

  • Defecto: ""
  • Tipo: Cuerda
orden de búsqueda

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: Cuerda
  • Valores: "nombre", "-nombre", "fecha", "-fecha", "descripción", "-descripción", "palabras clave", " -palabras clave"