JavaScript. Подробное руководство, 6-е издание, стр. 165

Для большинства своих методов этот модуль предоставляет синхронные версии. Любой метод, имя которого оканчивается на «Sync», является блокирующим методом, возвращающим значение и возбуждающим исключение. Методы для работы с файловой системой, имена которых не оканчиваются на «Sync», являются неблокирующими - они возвращают результаты или ошибки посредством передаваемых им функций обратного вызова. Следующий фрагмент демонстрирует, как реализуется чтение текстового файла с использованием блокирующего метода и как реализуется чтение двоичного файла с использованием неблокирующего метода:

// Синхронное чтение файла. Следует передать имя кодировки, 

// чтобы в результате получить текст, а не двоичные байты, 

var text = fs.readFileSync("config.json", "utf8");

<b>// Асинхронное чтение двоичного файла. Следует передать функцию, чтобы получить данные </b>

fs.readFile("image.png", function(err, buffer) { 

 if (err) throw err; // Если что-то пошло не так 

 process(buffer); // Содержимое файла в параметре buffer

});

Для записи в файл существуют аналогичные функции

writeFile()

writeFileSync()

fs.writeFile("config.json", JSON.stringify(userprefs));

Функции, представленные выше, интерпретируют содержимое файла как единственную строку или объект

Buffer

. Кроме того, для чтения и записи файлов интерпретатор Node определяет также API потоков ввода/вывода. Функция ниже копирует содержимое одного файла в другой:

// Копирование файлов с применением API потоков ввода/вывода.

// Чтобы определить момент окончания копирования,

// ей нужно передать функцию обратного вызова 

function fileCopy(filename1, filename2, done) {

 var input = fs.createReadStream(filenamel); // Входной поток

 var output = fs.createWriteStream(filename2); // Выходной поток

 input.on("data", function(d) { output.write(d); }); // Копировать

 input.on("error", function(err) { throw err; }); // Сообщить об ошибке

 input.on("end", function() { // По исчерпании входных данных

 output.end(); // закрыть выходной поток

 if (done) done(); // И известить вызвавшую программу

 });

}

Модуль «fs» включает также несколько методов, возвращающих список содержимого каталогов, атрибуты файлов и т. д. Следующая ниже программа для интерпретатора Node использует синхронные методы для получения списка содержимого каталога, а также для определения размеров файлов и времени последнего их изменения:

#! /usr/local/bin/node

var fs = require("fs"), path = require("path"); // Загрузить модули 

var dir = process.cwd(); // Текущий каталог 

var files = fs.readdirSync(dir); // Или из команд. строки 

var files = fs.readdirSync(dir); // Прочитать содер. кат-га 

process.stdout.write("Name\tSize\tDate\n"); // Вывести заголовок 

files.forEach(function(filename) { // Для каждого файла 

 var fullname = path.join(dir,filename); // Объед. имя и каталог 

 var stats = fs.statSync(fullname); // Получить атрибуты файла 

 if (stats.isDirectory()) filename += "/"; // Пометить подкаталоги 

 process.stdout.write(filename + // Вывести имя файла 

<b>        &quot;\t&quot; + stats.size + &quot;\t&quot; +              // размер файла </b>

<b>        stats.mtime + ”\n&quot;);                    // и время поcл. изменения</b>

});

Обратите внимание на комментарий #! в первой строке, в примере выше. Это специальный комментарий, используемый в Unix, чтобы объявить сценарий, следующий далее, исполняемым, определив файл интерпретатора, который должен его выполнить. Интерпретатор Node игнорирует подобные строки комментариев, когда они находятся в первых строках файлов.

Модуль «net» определяет API для организации взаимодействий по протоколу TCP. (Для выполнения сетевых взаимодействий на основе дейтаграмм можно использовать модуль «dgram».) Ниже приводится пример очень простого сетевого TCP-сервера, реализованного на основе особенностей Node:

<b>// Простой эхо-сервер, реализованный на основе особенностей Node:</b>

<b>// он ожидает соединений на порту с номером 2000 и отправляет обратно клиенту</b>

// все данные, которые получит от него.

var net = require('net');

var server = net.createServer();

server.listen(2000, function() {

console.log("Прослушивается порт 2000");

});

server.on("connection", function(stream) {