ما هي الـ Buffers في Node.js؟

Question

Accepted Answer

**Buffer** هي طريقة Node للتعامل مع **البيانات الثنائية الخام** — عبارة عن سلسلة بطول ثابت من البايتات مخزنة خارج heap الـ V8. بما أن سلاسل الأحرف (strings) في JavaScript مخصصة للنصوص (Unicode)، فإن الـ Buffers موجودة للعمل مع البيانات الثنائية: محتويات الملفات، حزم الشبكة، الصور، التشفير، إلخ.

## لماذا توجد الـ Buffers

```text
JavaScript strings → text (UTF-16). Can't cleanly represent arbitrary bytes.
Buffers → raw bytes (0–255 each). For binary data that isn't text.
```

عندما تقرأ ملفًا أو تستقبل بيانات من الشبكة، تصل كبايتات — كـ Buffer — والتي يمكنك بعد ذلك فك تشفيرها إلى نص إذا كانت نصية، أو معالجتها كبيانات ثنائية إذا لم تكن كذلك.

## إنشاء واستخدام الـ Buffers

```js
const buf = Buffer.from("Hello");          // from a string → bytes
const buf2 = Buffer.from([72, 105]);       // from byte values → "Hi"
const buf3 = Buffer.alloc(10);             // 10 zero-filled bytes

buf.length;          // 5 (bytes, not characters)
buf.toString("utf8"); // "Hello" — decode back to text
buf.toString("hex");  // "48656c6c6f"
buf.toString("base64"); // "SGVsbG8="
buf[0];              // 72 — access individual bytes
```

## حيث تظهر الـ Buffers

```js
// file reads without an encoding return a Buffer
const data = await fs.promises.readFile("image.png"); // Buffer (binary)
const text = await fs.promises.readFile("file.txt", "utf8"); // string (decoded)

// streams emit Buffer chunks
req.on("data", (chunk) => { /* chunk is a Buffer */ });

// crypto, compression, network protocols all work with Buffers
crypto.randomBytes(16); // a Buffer of 16 random bytes
```

إذا قرأت ملفًا *بدون* تحديد encoding، تحصل على Buffer؛ حدد `"utf8"` وسيقوم Node بفك تشفيره إلى نص لك.

## نقطة دقيقة: البايتات مقابل الأحرف

```js
Buffer.from("café").length; // 5 (é is 2 bytes in UTF-8) — NOT 4 characters
```

طول Buffer يكون بـ **البايتات**، والتي قد تختلف عن عدد الأحرف بالنسبة للنصوص متعددة البايتات (غير ASCII) — وهذا مهم عند تقسيم البيانات الثنائية.

## لماذا هذا مهم

الـ Buffers هي كيفية تعامل Node مع جميع **البيانات الثنائية**، وهو أمر لا مفر منه في عمل الخادم: قراءة الملفات غير النصية، معالجة التدفقات، بروتوكولات الشبكة، التشفير، رفع الصور/الملفات، والضغط.
هم أن المدخلات/المخرجات تتعامل بشكل أساسي مع البايتات (Buffers) — وكيفية التحويل بين الـ Buffers والنصوص باستخدام encoding الصحيح — أمر ضروري كلما تجاوزت النصوص العادية، وهذا يشكل أساس التدفقات (streams) وملف النظام والتشفير.