Node.js מול JavaScript: מה ההבדל?

JavaScript היא שפת תכנות; Node.js היא סביבת הרצה (runtime), תוכנה שמריצה JavaScript מחוץ לדפדפן. התחביר, הטיפוסים והאובייקטים הסטנדרטיים (Array, Promise, JSON) זהים בשניהם. מה שמשתנה הוא הסביבה סביב הקוד: דפדפן נותן לכם window ו-document כדי לעבוד עם דף web, ו-Node.js נותן לכם global, process, require ומודולים כמו fs כדי לעבוד עם קבצים, שרתים ומערכת ההפעלה.

console.log('window:', typeof window);
console.log('document:', typeof document);

console.log('global:', typeof global);
console.log('process:', typeof process);
console.log('require:', typeof require);
console.log('Buffer:', typeof Buffer);

console.log('globalThis is global:', globalThis === global);

האובייקטים הגלובליים של הדפדפן הדפיסו undefined, אלה של Node.js הדפיסו object או function, והשורה האחרונה הדפיסה true, כי ב-Node.js globalThis ו-global הם אותו אובייקט. הדביקו את שש השורות הראשונות ב-console של דפדפן והתוצאות יתהפכו.

ההבדל בטבלה אחת

שורת המודולים היא זו שמבלבלת הכי הרבה. Node.js תומך בשתי השיטות, require ו-import, ודפדפנים מבינים רק import. הדף CommonJS מול ES modules מסביר באיזו לבחור.

השפה זהה

פונקציה שמשתמשת רק בשפה רצה בכל מקום. בבלוק הזה אין שום דבר שייחודי ל-Node, והוא היה מדפיס את אותן שורות גם בדפדפן:

const scores = [72, 95, 88];

const best = Math.max(...scores);
const average = scores.reduce((sum, s) => sum + s, 0) / scores.length;

console.log(JSON.stringify({ best, average }));
console.log(`Passed: ${scores.filter((s) => s >= 80).length} of ${scores.length}`);

הוא הדפיס {"best":95,"average":85} ו-Passed: 2 of 3. תחביר ה-spread, reduce, תבניות מחרוזת ו-JSON שייכים לשפה ומוגדרים בתקן ECMAScript, ולכן הם קיימים בכל סביבת הרצה.

מה יש רק ב-Node.js

החלק הייחודי ל-Node הוא אוסף המודולים והאובייקטים הגלובליים המובנים שמדברים עם מערכת ההפעלה:

const fs = require('fs');
const path = require('path');

fs.writeFileSync('report.txt', 'line one\nline two\n');
const lines = fs.readFileSync('report.txt', 'utf8').trim().split('\n');

console.log(path.extname('report.txt'), lines.length, 'lines');
console.log('arguments after the script:', process.argv.slice(2));

הוא כתב קובץ, קרא אותו בחזרה והדפיס .txt 2 lines, ואז רשימה ריקה של ארגומנטים. לא גישה לקבצים ולא process.argv קיימים בדפדפן, שבו דף לא יכול לגעת בדיסק שלכם.

אילו יכולות של השפה תקבלו

לשפה יש גרסאות (ES2015, ES2020, ES2024 וכן הלאה), וכל מנוע מוסיף יכולות חדשות בקצב שלו. Node.js מגיע עם מנוע V8 מסוים בכל גרסה, כך שגרסת ה-Node.js שלכם קובעת אילו יכולות עובדות: Object.groupBy ו-Array.prototype.findLast, למשל, דורשים גרסה עדכנית. לכן טבלאות תמיכה של דפדפנים מציגות את Node.js כעוד עמודה לצד Chrome, Firefox ו-Safari. כשתחביר חדש נכשל עם SyntaxError או שמתודה היא undefined, הריצו node --version, ושדרגו לפני שאתם מחפשים polyfill.

קוד שרץ בשתי הסביבות

כותבי ספריות בודקים לפעמים איפה הקוד שלהם רץ לפני שהם משתמשים ב-API ייחודי לסביבה:

const isNode = typeof process !== 'undefined' && process.versions?.node != null;
const isBrowser = typeof window !== 'undefined';

כשאפשר, בדקו את היכולת שאתם צריכים ולא את שם הסביבה: typeof fetch === 'function' אומר יותר מאשר "האם זה Node". לשתיהן יש היום fetch, URL, TextEncoder, setTimeout ו-structuredClone, כך שפחות קוד צריך בדיקה כזו מאשר לפני כמה שנים.

טעויות נפוצות

שימוש ב-document או ב-window בסקריפט Node.js. תקבלו ReferenceError: document is not defined. הקוד הזה שייך לדפדפן.

שימוש ב-require בדפדפן. אין אותו בדפדפנים. השתמשו ב-import, או ב-bundler שהופך קריאות require לקובץ אחד.

לחשוב ש-Node.js היא שפה אחרת. היא לא. אם מדריך JavaScript מלמד משהו, זה עובד ב-Node.js, אלא אם הוא משתמש ב-DOM.