Basic Array Methods

console.log(Array.isArray([]));        // true
console.log(Array.isArray([1, 2]));    // true
console.log(Array.isArray(new Array())); // true
console.log(Array.isArray({}));        // false
console.log(Array.isArray("hello"));   // false
console.log(Array.isArray(null));      // false
console.log(Array.isArray(undefined)); // false

let fruits = ["Apple", "Banana"];
fruits.push("Mango");
console.log(fruits); // ["Apple", "Banana", "Mango"]

let numbers = [1, 2];
let newLength = numbers.push(3, 4);
console.log(numbers);   // [1, 2, 3, 4]
console.log(newLength); // 4

let fruits = ["Banana", "Mango"];
fruits.unshift("Apple");
console.log(fruits); // ["Apple", "Banana", "Mango"]

let queue = ["مهمة 2", "مهمة 3"];
let newLength = queue.unshift("مهمة 1");
console.log(queue);     // ["مهمة 1", "مهمة 2", "مهمة 3"]
console.log(newLength); // 3

let fruits = ["Apple", "Banana", "Mango"];
fruits.pop();
console.log(fruits); // ["Apple", "Banana"]
---------------------------------------------
---------------------------------------------
let letters = ['a', 'b', 'c'];
let removedLetter = letters.pop();
console.log(letters);       // ['a', 'b']
console.log(removedLetter); // 'c'

let emptyArr = [];
console.log(emptyArr.pop()); // undefined

let fruits = ["Apple", "Banana", "Mango"];
fruits.shift();
console.log(fruits); // ["Banana", "Mango"]

let tasks = ["غسيل", "طبخ", "قراءة"];
let firstTask = tasks.shift();
console.log(tasks);     // ["طبخ", "قراءة"]
console.log(firstTask); // "غسيل"

let months = ["يناير", "مارس", "أبريل", "يونيو"];

// إزالة عنصر واحد عند الفهرس 1
let removed = months.splice(1, 1);
console.log(months);   // ["يناير", "أبريل", "يونيو"]
console.log(removed); // ["مارس"]

// إزالة عنصرين بدءًا من الفهرس 1 واستبدالهما
removed = months.splice(1, 2, "مايو", "يونيو المعاد");
console.log(months);   // ["يناير", "مايو", "يونيو المعاد"]
console.log(removed); // ["أبريل", "يونيو"]

// إضافة عنصر عند الفهرس 1 دون حذف أي شيء
removed = months.splice(1, 0, "فبراير", "مارس", "أبريل");
console.log(months);   // ["يناير", "فبراير", "مارس", "أبريل", "مايو", "يونيو المعاد"]
console.log(removed); // [] (لم يتم حذف شيء)

// إزالة عنصر واحد من النهاية
removed = months.splice(-1, 1);
console.log(months);   // ["يناير", "فبراير", "مارس", "أبريل", "مايو"]
console.log(removed); // ["يونيو المعاد"]

let fruits = ["Apple", "Banana", "Mango"];

console.log(fruits.includes("Banana")); // true
console.log(fruits.includes("Orange")); // false

let pets = ["قطة", "كلب", NaN];
console.log(pets.includes("كلب"));  // true
console.log(pets.includes("حصان")); // false
console.log(pets.includes("قطة", 1)); // false (البحث يبدأ من الفهرس 1)
console.log(pets.includes(NaN));    // true (تعمل مع NaN!)

let names = ["Ali", "Sara", "Lina", "Ali"];

console.log(names.indexOf("Ali"));   // 0 (أول ظهور لـ Ali)
console.log(names.indexOf("Lina"));  // 2
console.log(names.indexOf("John"));  // -1 (غير موجود)

let nums = [10, 20, 30, 20, 40];
console.log(nums.indexOf(20));       // 1 (أول ظهور)
console.log(nums.indexOf(20, 2));    // 3 (أول ظهور بدءًا من الفهرس 2)
console.log(nums.indexOf(50));       // -1 (غير موجود)
console.log(nums.indexOf("20"));     // -1 (النوع مختلف)
console.log([NaN].indexOf(NaN));     // -1 (لا تعمل بشكل صحيح مع NaN)

let colors = ["Red", "Green", "Blue"];

let color = "Green";

console.log(colors.includes(color)); // true
console.log(colors.indexOf(color));  // 1

let subjects = ["Math", "English", "Physics"];

console.log(subjects.includes("Physics")); // true
console.log(subjects.indexOf("Biology"));  // -1

let numbers = [10, 20, 30, 40];

console.log(numbers.includes(30));    // true
console.log(numbers.indexOf(50));     // -1

let tools = ["Hammer", "Screwdriver", "Wrench"];

if (tools.includes("Wrench")) {
  console.log("الأداة موجودة");
} else {
  console.log("الأداة غير موجودة");
}

let nums = [10, 20, 30, 20, 40];
console.log(nums.lastIndexOf(20));    // 3 (آخر ظهور)
console.log(nums.lastIndexOf(20, 2)); // 1 (آخر ظهور قبل أو عند الفهرس 2)

// السلوك الافتراضي (خاطئ للأرقام)
let numbers = [10, 5, 100, 1, 25];
numbers.sort();
console.log(numbers); // [1, 10, 100, 25, 5] (ترتيب كنصوص: "1", "10", "100", "25", "5")

// الترتيب الصحيح للأرقام (تصاعدي)
numbers.sort(function(a, b) {
    return a - b; // إذا a<b سالب, إذا a>b موجب, إذا a=b صفر
});
// أو باستخدام دالة سهمية (Arrow Function)
// numbers.sort((a, b) => a - b);
console.log(numbers); // [1, 5, 10, 25, 100]

// الترتيب التنازلي للأرقام
numbers.sort((a, b) => b - a);
console.log(numbers); // [100, 25, 10, 5, 1]

// ترتيب السلاسل النصية (الافتراضي يعمل جيدًا للحروف الإنجليزية)
let words = ["banana", "apple", "cherry"];
words.sort();
console.log(words); // ["apple", "banana", "cherry"]
// للغة العربية، قد تحتاج لدالة localeCompare للترتيب الدقيق
let arabicWords = ["تفاح", "موز", "كرز"];
arabicWords.sort((a, b) => a.localeCompare(b, 'ar'));
console.log(arabicWords); // ["تفاح", "كرز", "موز"] (أو ترتيب آخر حسب معايير 'ar')

// ترتيب مصفوفة من الكائنات
let people = [
    { name: "علي", age: 30 },
    { name: "فاطمة", age: 25 },
    { name: "أحمد", age: 35 }
];
// الترتيب حسب العمر (تصاعدي)
people.sort((a, b) => a.age - b.age);
console.log(people);
/*
[
  { name: 'فاطمة', age: 25 },
  { name: 'علي', age: 30 },
  { name: 'أحمد', age: 35 }
]
*/
// الترتيب حسب الاسم (أبجدي)
people.sort((a, b) => a.name.localeCompare(b.name, 'ar'));
console.log(people);
/*
[
  { name: 'أحمد', age: 35 },
  { name: 'علي', age: 30 },
  { name: 'فاطمة', age: 25 }
]
*/

let letters = ['a', 'b', 'c'];
let reversedLetters = letters.reverse();
console.log(letters);         // ['c', 'b', 'a'] (الأصل تغير)
console.log(reversedLetters); // ['c', 'b', 'a'] (نفس مرجع المصفوفة الأصلية)

let letters = ['a', 'b', 'c', 'd', 'e'];
let slice1 = letters.slice(1, 3); // من الفهرس 1 إلى ما قبل 3
console.log(slice1);          // ['b', 'c']
console.log(letters);         // ['a', 'b', 'c', 'd', 'e'] (الأصل لم يتغير)

let slice2 = letters.slice(2); // من الفهرس 2 إلى النهاية
console.log(slice2);          // ['c', 'd', 'e']

let slice3 = letters.slice(-2); // آخر عنصرين
console.log(slice3);          // ['d', 'e']

let shallowCopy = letters.slice(); // نسخة سطحية كاملة
console.log(shallowCopy);     // ['a', 'b', 'c', 'd', 'e']
shallowCopy[0] = 'X';
console.log(letters[0]); // 'a' (الأصل لم يتأثر للعناصر البسيطة)

let nested = [1, [2, 3]];
let nestedCopy = nested.slice();
nestedCopy[1][0] = 99;
console.log(nested[1][0]); // 99 (الأصل تأثر لأن المصفوفة الداخلية نُسخت كمرجع)

let arr1 = [1, 2];
let arr2 = [3, 4];
let arr3 = [7, 8];
let value = 5;

let combined1 = arr1.concat(arr2);
console.log(combined1); // [1, 2, 3, 4]

let combined2 = arr1.concat(value, arr2, 6);
console.log(combined2); // [1, 2, 5, 3, 4, 6]

let combined3 = arr1.concat(arr2, arr3);
console.log(combined3); // [1, 2, 3, 4, 7, 8]

let nestedConcat = [1].concat([2, [3, 4]]);
console.log(nestedConcat); // [1, 2, [3, 4]] (لا يتم تسطيح المصفوفات المتداخلة)

console.log(arr1); // [1, 2] (الأصل لم يتغير)

let parts = ["هذا", "مثال", "للانضمام"];
console.log(parts.join());      // "هذا,مثال,للانضمام" (الافتراضي)
console.log(parts.join(" "));    // "هذا مثال للانضمام"
console.log(parts.join(" - ")); // "هذا - مثال - للانضمام"
console.log([1, 2, 3].join("")); // "123"

array.flat(depth)

let arr = [1, 2, [3, 4]];
let result = arr.flat();

console.log(result);  // [1, 2, 3, 4]

let deepArr = [1, 2, [3, 4, [5, 6]]];

let result1 = deepArr.flat();      // مستوى واحد فقط
console.log(result1);              // [1, 2, 3, 4, [5, 6]]

let result2 = deepArr.flat(2);     // مستويين
console.log(result2);              // [1, 2, 3, 4, 5, 6]