Hoe npm (Node.js Pakketbeheerder) inschakelen en gebruiken in ServBay

npm (Node Package Manager) is de officiële pakketbeheerder van Node.js en een van 's werelds grootste open source softwarebibliotheken. Voor Node.js ontwikkelaars is npm onmisbaar: het helpt je eenvoudig projectafhankelijkheden te installeren, delen en beheren. Dankzij de geïntegreerde omgeving van ServBay kun je razendsnel aan de slag met npm voor jouw ontwikkeltraject.

Vereisten

Voordat je npm gebruikt, moet Node.js geïnstalleerd zijn in ServBay.

1. Open de ServBay-app.
2. Navigeer naar het paneel “Packages”.
3. Zoek het Node.js-pakket en zorg dat dit geïnstalleerd en actief is.

ServBay configureert automatisch de Node.js-omgeving, inclusief npm.

Controleren of npm geïnstalleerd en beschikbaar is

Node.js geïnstalleerd via ServBay komt standaard met een werkende versie van npm. Je kunt eenvoudig controleren of npm correct geïnstalleerd is via de terminal.

1. Open een terminal-applicatie (zoals Terminal op macOS).

2. Voer het volgende commando uit om het npm-versienummer te bekijken:

   npm -v

   Als het commando slaagt en een versienummer (zoals 10.2.0 of nieuwer) toont, is npm correct geïnstalleerd en direct bruikbaar in je huidige omgeving.

   # Voorbeeldoutput
   10.2.0

   Zie je een foutmelding als “command not found: npm”, controleer dan of Node.js via ServBay is geïnstalleerd en of de ServBay-omgevingsvariabelen correct geladen zijn (vaak helpt het opnieuw opstarten van je terminal of computer om padproblemen op te lossen).

npm updaten

Hoewel Node.js via ServBay doorgaans een stabiele versie van npm meelevert, verschijnt er regelmatig een nieuwe npm-versie onafhankelijk van Node.js. Om nieuwe functies en bugfixes te ontvangen, kun je npm updaten met het volgende commando:

npm install -g npm@latest

Dit installeert de nieuwste versie van npm globaal. De -g vlag betekent dat de update overal beschikbaar is, zodat je overal met de nieuwste versie werkt.

Na het updaten kun je opnieuw controleren met:

npm -v

Kernfuncties en gebruik van npm

De kracht van npm zit in het gigantische ecosysteem en het eenvoudige afhankelijkheidsbeheer. Hieronder vind je veelvoorkomende scenario’s en commando’s voor dagelijks npm-gebruik:

Een nieuw Node.js-project initialiseren

Als je een nieuw Node.js-project in een lege map start, kun je met npm init een package.json bestand aanmaken. Dit bestand bevat de kerninformatie van je project, zoals metadata, afhankelijkheden en scripts.

cd /Applications/ServBay/www/my-new-project.servbay.demo
npm init

npm init begeleidt je door het instellen van de projectnaam, versie, beschrijving, hoofdbestand enzovoorts. Met npm init -y genereer je snel een standaard package.json.

Projectafhankelijkheden installeren

In de rootmap van je project (waar package.json zich bevindt) installeer je alle benodigde dependencies met:

cd /Applications/ServBay/www/my-project.servbay.demo
npm install

Dit commando leest de velden dependencies en devDependencies uit package.json en downloadt de bijbehorende modules naar de map node_modules van je project.

Nieuwe afhankelijkheden toevoegen

Heb je een extra bibliotheek of framework nodig, gebruik dan:

# Installeer een runtime dependency, zoals het Express framework
npm install express

# Installeer een dependency voor ontwikkeling, bijvoorbeeld Mocha voor testen
npm install mocha --save-dev

Standaard worden packages in de map node_modules geïnstalleerd en voegt npm ze toe aan het veld dependencies in package.json. Met de --save-dev vlag worden pakketten opgeslagen onder devDependencies; dit is handig voor ontwikkel-, test- of buildtools.

Afhankelijkheden verwijderen

Onnodige pakketten kun je verwijderen met:

npm uninstall express

Dit verwijdert het pakket uit node_modules en past package.json automatisch aan.

Projectafhankelijkheden updaten

Om te controleren of je dependencies up-to-date zijn (binnen de opgegeven versiebereiken in package.json), gebruik je:

npm update

npm bekijkt alle geïnstalleerde pakketten in node_modules en werkt ze bij naar de nieuwste compatibele versie.

Werken met npm scripts

Het scripts veld in package.json biedt ruimte voor eigen commando's. Hiermee kun je als ontwikkelaar terugkerende taken, zoals development servers, tests of builds, automatiseren.

Bijvoorbeeld, voeg in je package.json deze scripts toe:

{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "start": "node index.js",
    "test": "mocha test/**/*.js",
    "build": "webpack --config webpack.config.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "mocha": "^10.2.0",
    "webpack": "^5.89.0"
  }
}

Je kunt deze scripts uitvoeren met:

# Applicatie starten
npm start

# Tests uitvoeren
npm test

# Bouwen
npm run build

Let op: voor scripts als start, test, install, restart, stop en enkele andere hoef je geen run te typen—gewoon npm start, npm test, enzovoort, volstaat.

Snel overzicht van handige npm-commando's

Behalve de basiscommando’s zijn er nog andere veelgebruikte npm-functies:

• Globale packages installeren: Voor het installeren van tools die overal in je systeem beschikbaar moeten zijn.

  npm install -g <package-name>
  # Bijvoorbeeld: npx installeren (meestal al aanwezig bij Node.js)
  npm install -g npx
  # Bijvoorbeeld: de handige tool nodemon voor automatisch herstarten tijdens development
  npm install -g nodemon

• Tijdelijke commando's uitvoeren (npx): Met npx (vanaf npm 5.2+) kun je scripts vanuit node_modules/.bin draaien of eenmaal pakketten uitvoeren zonder ze globaal te installeren.

  # Maak een nieuw React-project aan zonder create-react-app te installeren
  npx create-react-app my-react-app

• Globaal geïnstalleerde packages bekijken: Lijst alle wereldwijd geïnstalleerde pakketten en hun versies.

  npm list -g --depth=0

• npm-cache opschonen: Problemen bij het installeren kunnen aan beschadigde cache liggen; opschonen helpt dan soms.

  npm cache clean --force

• Informatie over een pakket bekijken: Toont details zoals versie, afhankelijkheden en repository van een package.

  npm view <package-name>

• Zoeken naar packages: Doorzoek de officiële npm repository.

  npm search <keyword>

Probleemoplossing

• npm command not found: Controleer of het Node.js-pakket via ServBay is geïnstalleerd en of je terminalsessie de paden naar Node.js en npm ziet (vaak helpt herstarten van de terminal of je computer).
• Installatie van dependencies mislukt: Controleer je internetverbinding. Bedrijfsmatige proxy-instellingen kunnen invloed hebben op npm; stel eventueel een npm-proxy in. Probeer anders eerst de cache te wissen (npm cache clean --force) en probeer het nog eens.
• Machtigingen/problemen met rechten: Bij globale installaties (npm install -g) op macOS kunnen rechtenproblemen ontstaan. Gebruik bij voorkeur een Node Version Manager (nvm) of zorg dat ServBay het installatielocatie juist heeft geconfigureerd. Vermijd het gebruik van sudo voor globale npm-installaties, omdat dit latere complicaties kan geven. Node.js geïnstalleerd via ServBay heeft doorgaans machtigingskwesties al afgevangen, zodat je vrij binnen de ServBay-directory kunt werken.

Samenvatting

Met ServBay beschik je snel over een krachtige, lokale Node.js ontwikkelomgeving en kun je direct aan de slag met het veelzijdige npm voor pakketbeheer en projectontwikkeling. Door de basishandelingen en veelgebruikte npm-commando's onder de knie te krijgen, verhoog je je productiviteit aanzienlijk. Hoe verder je de Node.js-ecosysteem induikt, hoe onmisbaarder npm als jouw vaste ontwikkelpartner zal aanvoelen.