Пакетный менеджер

npm (Node Package Manager)

• Web-ресурс https://www.npmjs.com/
  Поиск пакетов, документация для пакета, управление пакетами (публикация) и др.
• Командная строка (CLI)
  Работа с проектом
• База пакетов (registry)
  

Секции package.json

name, author, contributors, bugs, homepage, version, license, keywords, description, repository, main, private, scripts, dependencies, devDependencies, engines, browserslist

Секция main

Точка входа в проект

					
					    "main": "src/main.js"
					
					

Секция scripts

Скрипты, которые можно запускать

"scripts": {
  "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
  "start": "npm run dev",
  "unit": "jest --config test/unit/jest.conf.js --coverage",
  "test": "npm run unit",
  "lint": "eslint --ext .js,.vue src test/unit",
  "build": "node build/build.js"
}

					

Секция dependencies

Список зависимостей, необходимых для выполнения проекта

					
"dependencies": {
  "vue": "^2.5.2"
}
					
					

Секция devDependencies

Список зависимостей, необходимых для разработки проекта

					
"devDependencies": {
  "autoprefixer": "^7.1.2",
  "babel-core": "^6.22.1"
}
					
					

Указание версий

• <major>.<minor>.<patch> - общая идеология
• ~ - обновление только patch. Для ~0.13.1 до 0.13.2 обновится, а до 0.14.0 - нет.
• ^ - обновление только minor и patch. Для ^0.13.1 обновится и до 0.13.2 и до 0.14.0.
• * - обновление всех версий.

• > - версия больше указанной.
• >= - указанная версия или больше указанной.
• <= - указанная версия или меньше указанной.
• < - меньше указанной.
• 1.0.0 || >=1.1.0 <1.2.0 - любые комбинации.
• если ничего не указана, то применима только указанная.
• latest - последняя выпущенная версия.

Установка пакетов

• Установить все из package.json
  npm install
• Установить пакет package
  npm install package
• Установить пакет package заданой версии
  npm install package@1.0.2

Рекомендация: устанавливать пакет глобально, только если он предоставляет выполняемые команды, которые могут быть использованы для всех проектов.

Установить глобально (необходимы права администратора):

Событийная модель: концепция асинхроности.

• Один поток.
• Класс EventEmitter.
• Очередь событий, цикл событий.
• Регистрация обработчика события.
• Генерация события.

Регистрация и генерация события

				    
const EventEmitter = require('events');

class MyEmitter extends EventEmitter {}

const myEmitter = new MyEmitter();
myEmitter.on('event', () => {
    console.log('an event occurred!');
});
myEmitter.emit('event');
				    
				    

Передача нескольких аргументов в событие

				    
const EventEmitter = require('events');

class MyEmitter extends EventEmitter {}

const myEmitter = new MyEmitter();
myEmitter.on('event', (a, b) => {
    console.log('an event occurred:', a + b);
});
myEmitter.emit('event', 1, 3);
				    
				    

Синхронное и асинхронное

				    
setTimeout(callback, 0)
process.nextTick(callback)
				    
				    

Модульность

				    
// Импорт локального модуля:
const myLocalModule = require('./path/myLocalModule');

// Импорт JSON файла
const jsonData = require('./path/filename.json');

// Импорт из node_modules или встроенного в Node.js модуля:
const crypto = require('crypto');
				    
				    
				    

				    
// Модуль.
module.exports = class Square {
  constructor(width) {
    this.width = width;
  }

  area() {
    return this.width ** 2;
  }
};
				    
				    

Работы с файловой системой

				    
// Асинхронная обработка.
const fs = require('fs');

fs.unlink('/tmp/hello', (err) => {
  if (err) throw err;
  console.log('successfully deleted /tmp/hello');
});
				    
				    
				    

				    
// Синхронная обработка.
const fs = require('fs');

try {
  fs.unlinkSync('/tmp/hello');
  console.log('successfully deleted /tmp/hello');
} catch (err) {
  // handle the error
}
				    
				    
				    

• Абсолютный путь.
• Относительный путь.
• URL.

				    
fs.readFileSync('/tmp/hello');				    
fs.readFileSync('../hello');				    
fs.readFileSync(new URL('file:///tmp/hello'));				    
				    
				    

Работа с ошибками

				    
const fs = require('fs');
fs.unlinkSync('/tmp/hello');
				    
				    
				    

				    
try {
    fs.unlinkSync('./hello');
    console.log('successfully deleted /tmp/hello');
} catch (err) {
  // handle the error
  console.log('File not deleted');
}

				    
				    

Класс Error

				    
const EventEmitter = require('events');
const ee = new EventEmitter();

setImmediate(() => {
  // This will crash the process because no 'error' event
  // handler has been added.
  ee.emit('error', new Error('This will crash'));
});