Урок за Node.js за принципи: de cero a your primera app

Начало » Питон » Урок за Node.js за принципи: de cero a your primera app

Ако сте пример за контакт с Node.js, aquí tienes una guía pensada para empezar con buen pie: iremos de lo más básico a un flujo de trabajo real, con ejemplos prácticos y explicaciones claras. Te acompañaré desde el mítico Hola Mundo hasta levantar una app web con Express, pasando por módulos del system, npm y el enfoque asíncrono que hace tan, especial al ecosistema de Node.

Допълнителни насоки с предишни изисквания, конфигуриране на Visual Studio Code и примерни проекти, verás cómo organizar un server HTTP, enrutar peticiones, manejar controladores, trabajar con datos POST sin bloquear el hilo y entender la losofía event-driven. Todo con un lenguaje cercano, sin rodeos, y con el toque necesario para que no te pierdas.

Requisitos previos y qué esperar de Node.js

Necesitarás unos conocimientos básicos de JavaScript (tipos, variables, funciones, objetos) y ganas de probar cosas con la consola. Node.js е entorno de ejecución de JavaScript fuera del navegador, basado en V8, con una librería estándar potente y un modelo de ejecución dirigido por eventos y no bloqueante. Esto le permite gestionar muchas conexiones concurrentes sin crear un hilo por cada petición.

С възел може да се изгради сървъри в мрежата, REST APIs, herramientas de línea de comandos, apps en tiempo real (чат, нотификации), integraciones con bases de datos и hasta proyectos IoT. Su fortaleza está en el manejo de E/S concurrente, lo que lo hace ideal para trafico alto y experiencias interactivas.

Изтеглете и инсталирайте

Изтеглете Node.js от официалния сайт en nodejs.org и е инсталиран за вашата оперативна система. Windows, macOS или Linux се инсталират и имат подходящи пакети. Tras la instalación, потвърдете в терминала con: node -v y npm -v. npm es el gestor de paquetes de Node y te permitirá instalar librerías de terceros de forma sencila.

Вашият първи контакт: Hola Mundo con VS Code

Ако използвате Visual Studio Code, puedes abrir la carpeta del proyecto y lanzar el terminal integrado con total comodidad. Crea una carpeta de trabajo y entra en ella: mkdir HelloNode && cd HelloNode.

Ahora abre esa carpeta en VS Code con код.. Създайте файл, наречен app.js e въведе algo sencillo para arrancar: съобщение от конзола.

var msg = 'Hello World';
console.log(msg);

За изваждане, след интегриране на терминал във VS код (Версия > Терминал, или добавяне на Ctrl+`), и следното node app.js. Verás el clásico продукция „Hello World“ en la consola; sí, sencillo, pero confirma que todo va bien.

Всъщност сървър: минимален HTTP сървър

Node trae un módulo nativo llamado 'http' con el que puedes crear un servidor en pocas líneas. El corazón es http.createServer, que recibe una función callback que se ejecuta cada vez que llega una petición.

var http = require('http');

http.createServer(function (request, response) {
  response.writeHead(200, {'Content-Type': 'text/html'});
  response.write('Hola Mundo');
  response.end();
}).listen(8888);

Аранкало кон node server.js и посети http://localhost:8888/. La magia de Node está en su modelo orientado a eventos: pasas una función y el runtime la “llama de vuelta” (обратно повикване) cuando sucede el evento (una petición entrante).

Entendiendo callbacks, asincronía y flujo de ejecución

En JavaScript las funciones son ciudadanos de primera: se pueden pasar como argumentos, devolver y almacenar en variables. Este patrón encaja con el bucle de eventos de Node: tu código registra funciones que se ejecutan cuando curren sucesos (por ejemplo, llega una petición HTTP).

От решаващо значение е да се разбере разликата между operaciones bloqueantes y no bloqueantes. Si въвежда algo que ocupa la CPU durante segundos (por ejemplo, un bucle de espera), el proceso entero se detiene y todas las peticiones sufren. En Node, trabaja siempre que puedas con E/S asíncrona y обратни повиквания o promesas para evitar bloquear el hilo.

Модулен дизайн: сървър, рутер и управление

Разделяне на отговорности te ayudará a escalar el proyecto: un modulo para el server HTTP, otro para el enrutador y otros para los controladores (обработващи заявки). Puedes exponer funciones con exports y requerir módulos locales con require('./miModulo').

Una estructura típica podría ser: index.js като входна точка, server.js с HTTP сървъра, router.js para decidir a qué función mandar cada ruta y requestHandlers.js con la lógica de cada endpoint. Esta organización mantiene el código lisible y fácil de probar.

Extrayendo la ruta y enrutando

Заявката за обекта е поискана от URL адресНачалникът на модула url разрешително за екстрахиране име на път y, si hace falta, la query. Con eso, el ruter podrá decidir qué controlador ejecutar.

var url = require('url');

function onRequest(request, response) {
  var pathname = url.parse(request.url).pathname;
  // route(pathname) ...
}

Рутерът го получава карта на функционалните маршрути (un objeto donde cada clave es una ruta, y el valor, el handler), junto con el pathname, y comprueba si hay una función asociada. Si existe, la ejecuta; si no, devuelve un 404.

Haciendo que el handler responda (el patrón correcto)

Обичайно изкушение es hacer que el controlador retorne un string y que el server lo escriba. Pero esto falla cuando el handler necesita hacer algo asíncrono (como leer de disco o ejecutar un comando). La solución efectiva es инжектирай отговора на обекта hasta el handler y que el propio handler escriba la respuesta cuando la tenga (por ejemplo, dentro del callback de una función asíncrona).

// router.js
function route(handle, pathname, response) {
  if (typeof handle[pathname] === 'function') {
    handle[pathname](response);
  } else {
    response.writeHead(404, {'Content-Type': 'text/html'});
    response.write('404 No Encontrado');
    response.end();
  }
}

Този подход позволява responder justo cuando la E/S asíncrona concluye, sin bloquear el processo ni forzar a devolver datos antes de tiempo.

Express: създайте уеб приложение за минути

Express е минималистична рамка за Node.js que facilita gestionar rutas, vistas, middleware и utilidades HTTP. Con su generador puedes crear la estructura de un proyecto en segundos, con carpetas para rutas, vistas y recursos estáticos.

1. Създайте папка за вашите проекти: mkdir ExpressProjects && cd ExpressProjects.
2. Родове едно растение: npx express-generator HelloWorld --view=pug създайте приложение с моторни изгледи Pug.
3. Открийте VS Code с code . и преглед на структурата: кофа за боклук (аранжиране), обществен (JS/CSS/изображения), маршрути (контрольори на маршрути), гледания (плантили), app.js (конфигурация), package.json (скриптове и зависимости).
4. Инсталиране на зависимости с npm install върху килима на проекта.
5. Стартирайте приложението. Por ejemplo, con depuración: npx cross-env DEBUG=HelloWorld:* npm start.
6. отваря http://localhost:3000. Prueba a cambiar la vista principal: Аз Н views/index.pug, заменя заглавието с h1 "Hello World!" и презареждане.

Express incorpora lo necesario para управлява GET, POST, PUT и DELETE, използване на мидълуер, estáticos servir, renderizar vistas y estructurar una app de varias páginas con menos fricción.

npm и модули, включени в Node

npm es el gestor de paquetes de Node y te permite instalar librerías de terceros. Например, за añadir Express: npm install expressСлед това require('express') y utilizarlo en tu código. Esta flexibilidad es clave para crecer con tu proyecto.

Además, Включен възел нативни модули за общините: fs (архиви), http/https (сервидори), path (рути), os (данни от системата), url (анализ на URL) y muchos más. Puedes importarlos con require() без да инсталирате нищо.

Probando un módulo nativo: información del system

Модулът 'os' ofrece datos del system operativo. Abre la consola y entra en el REPL de Node con node para probar funciones rápidamente sin crear archivos.

1. пиша os.platform() за saber la platforma (win32, linux, darwin...). Потвърдете активната SO директно.
2. Con os.arch() придобиване на архитектура (x64, arm64…). Използва се за бинарни файлове или компилации.
3. Употреба os.cpus() para ver los nucleos disponibles. Идеален за равновесно натоварване con clusteres o processos hijos.
4. Сал дел REPL с .exit или натиснете Ctrl+C два пъти. Бързо и без остатъци.

Biblioteca de terceros útil en el día a día

Екосистемата npm е огромна. Algunas utilidades populares: остър (tratamiento de mágenes y compresión), PDFKit (генериране на PDF), validator.js (валидация на кадифета), imagemin y UglifyJS (минимизиране), спрайтсмит (спрайтове), Уинстън (дървосечене) y commander.js (CLI). Инсталирано с npm install <paquete> когато имате нужда от тях.

Как да извадим код Node.js от архива

Guarda tu código en un archivo, por ejemplo app.jsи изхвърлих с node app.js на терминала. Esto inicia tu program y verás los resultados en consola o, si levantas un servidor, en tu navegador.

Del REPL a la aplicación real: flujo completo

Probar en el REPL es perfecto para funciones pequeñas, pero en cuanto tu código crece, te conviene pasar a archivos, organizar modulos y añadir scripts de npm. De esta forma podrás automatizar tareas con npm run y documentar los comandos de inicio en package.json.

Manejando datos POST грях блокира

Cuando un usuario envía un formulario, el cuerpo de la petición puede llegar en varios trozos. В сървъра (обратно извикване от createServer) слушатели на añade data y end para ir acumulando el contenido y processarlo al final. Indica también la codification, por ejemplo UTF-8, para manipularlo correctamente.

request.setEncoding('utf8');
var postBody = '';
request.addListener('data', function(chunk) {
  postBody += chunk;
});
request.addListener('end', function() {
  // route(handle, pathname, response, postBody)
});

Si necesitas extraer campos individuales, използвайте модула „querystring“ para parsear el cuerpo cuando llega como application/x-www-form-urlencoded: querystring.parse(postBody).text, Например.

Operaciones costosas y exec no bloqueante

За изхвърляне на команди на системата разпознаване на греха el servidor, utiliza child_process.exec y responde en el callback. Puedes añadir opciones como timeout o maxBuffer para controlar comandos pesados. El patrón es siempre el mismo: нищо не може да се блокира, y responder cuando haya datos.

var exec = require('child_process').exec;

function handler(response) {
  exec('ls -lah', function(error, stdout, stderr) {
    response.writeHead(200, {'Content-Type': 'text/plain'});
    response.write(stdout);
    response.end();
  });
}

Si cambias el comando por algo más exigente, el resto de rutas seguirá respondiendo con normalidad siempre que no hagas trabajo sincrónico costoso en el hilo principal.

Subidas de ficheros: enfoque y herramientas

За управление на многостранни качвания (imagenes u drugi archivos) lo más práctico es recurrir a un paquete specializado. Modulos como страхотен улесняване на анализа на формуляри multipart/form-data, acceder a los archivos temporales y moverlos a su destino. La idea es la misma: обратни повиквания/обещания y trabajar de forma segura con streams.

Aunque la implementación completa escapa a los primeros pasos, lo importante es que integres el upload en tu flujo: сървъра който получава формуляра, рутер que dirige a la ruta de subida, y секундант que valida, guarda y responde con el resultado (por ejemplo, mostrando la imagen).

Estructura de vistas y contenido dinámico

Si optas por Express con Pug u otro motor, el controlador pasa datos a la vista y esta los renderiza. Para un formulario sencillo con un textarea enviado por POST y una ruta que lo muestra, basta con dos handlers: uno que sirve el formulario y otro que procesa y devuelve el contenido получени.

Добри организационни практики

Монолитични архиви на Евита. Divide en Módulos, nombra funciones con verbos que expresen acciones (por ejemplo, iniciar, subir, списък), y desacopla con inyección de dependencias cuando tenga sentido (pasando funciones o mapas de rutas al servidor y al router). Mantener las capas ligeras te permitirá crecer sin dolores.

Можете да конструирате с Node.js

Този модел е управляван от събития и не е блокиран има специално предназначение за: уеб сървъри, API REST, реални приложения (чат, табла за управление), ботове и CLI, интеграции с бази на данни, кодове за работа, и контрол на хардуера. La facilidad para manejar websockets y streaming lo convierte en una elección natural para experiencias interactivas.

• Уеб сървъри и сайтове с растения или SSR.
• REST API preparadas para alto trafico.
• В реално време със сокети за чат, известия или игри.
• инструменти на командния ред да автоматизирате задачи.
• Procesos con ficheros y bases de datos, кола и тръбопроводи.
• IoT и хардуер със специфични библиотеки.

Herramientas de aprendizaje y práctica

Existen entornos interactivos que muestran código y salida lado a lado, ideales para entender ejemplos rápidos. Aun así, podrás progresar sin crear cuentas: documentarte, copiar ejemplos y ejecutar en local con tu terminal es más que suficiente al principio.

Visual Studio Code: productividad sin salir del editor

El terminal integrado, el depurador y las extensiones de VS Code hacen que trabajar con Node sea muy cómodo. От „Ver > Terminal“ се отварят черупки, cambiar el predeterminado y ejecutar node o npm run грях изоставя редактор. Адемас, конфигуриране на launch.json te permitirá depurar paso a paso.

Apuntes de versión y estabilidad

Muchas guías clásicas se probaron con versiones antiguas de Node, pero los conceptos se mantienen vigentes: обратни повиквания, nativos modulos, asincronía, enrutado y separación de responsabilidades. Hoy trabajarás con versiones actuales, más rápidas y seguras, y con un ecosistema npm aún más rico.

Изтегляне и допълнителни рекурсии

Puedes ampliar estudio con documentación, PDF файлове и уроци. Revisa siempre la web oficial de Node para novedades y descarga, e identifica fuentes didácticas que incluyan изстрели, викторини и шеги para afianzar conocimientos a medida que avances.

Si buscas material complementario, encontrarás guías introductorias y referencias prácticas con ejemplos, así como enlaces de descarga cuando sea necesario. Поддържай фокуса си на практика: leer está bien; ejecutar, romper cosas y arreglarlas, mejor.

Пълен пример: мини приложение с рутер и манипулатори

Джунтандо пиезиПредставете си проект с index.js който подрежда слугата, server.js с HTTP и парсинг на POST, router.js que реши qué función ejecutar y requestHandlers.js con dos rutas: una que muestra un formulario y otra que enseña el texto enviado.

// index.js
var server = require('./server');
var router = require('./router');
var handlers = require('./requestHandlers');

var handle = {};
handle['/'] = handlers.iniciar;
handle['/iniciar'] = handlers.iniciar;
handle['/subir'] = handlers.subir;

server.iniciar(router.route, handle);

// server.js
var http = require('http');
var url = require('url');

function iniciar(route, handle) {
  function onRequest(request, response) {
    var postData = '';
    var pathname = url.parse(request.url).pathname;

    request.setEncoding('utf8');
    request.addListener('data', function(chunk) { postData += chunk; });
    request.addListener('end', function() {
      route(handle, pathname, response, postData);
    });
  }

  http.createServer(onRequest).listen(8888);
}

exports.iniciar = iniciar;

// router.js
function route(handle, pathname, response, postData) {
  if (typeof handle[pathname] === 'function') {
    handle[pathname](response, postData);
  } else {
    response.writeHead(404, {'Content-Type': 'text/html'});
    response.end('404 No Encontrado');
  }
}

exports.route = route;

// requestHandlers.js
var querystring = require('querystring');

function iniciar(response) {
  var body = '<html>'+
    '<head><meta charset=\'UTF-8\' /></head>'+
    '<body>'+
    '<form action=\'/subir\' method=\'post\'>'+
    '<textarea name=\'text\' rows=\'10\' cols=\'40\'></textarea>'+
    '<input type=\'submit\' value=\'Enviar\' />'+
    '</form>'+
    '</body></html>';

  response.writeHead(200, {'Content-Type': 'text/html'});
  response.end(body);
}

function subir(response, postData) {
  var text = querystring.parse(postData).text || '';
  response.writeHead(200, {'Content-Type': 'text/html'});
  response.end('Tu enviaste: ' + text);
}

exports.iniciar = iniciar;
exports.subir = subir;

Con este esqueleto mínimo ya tienes сървърът е функционален и не е блокиран, con rutas y controladores separados, preparado para crecer hacia vistas, uploads or integración con bases de datos.

La clave de Node está en pensar en “acciones”: pasar funciones, inyectar dependencias cuando convenga y mantener pequeños los bloques de responsabilidad. Así, tu aplicación será más fácil de mantener y adapter conforme aumente su complejidad.

Todo lo visto te da una base sólida: desde instalar Node y ejecutar tu primer script, pasando por VS Code, един HTTP нативен сървър, enrutado propio, Express, npm, nativos модули, REPL, asincronía sin bloqueos y manejo de formularios POST. Con practica y pequeñas iteraciones, podrás construir proyectos cada vez más completos sin perder claridad en el codigo.