Type: Object

Колекція функцій Object.

Див. також:

Function: Object.each

Використовується для ітерації через об'єкт.

Синтаксис:

Object.each(obj, fn[, bind]);

Аргументи:

  1. obj - (object) Об'єкт для ітерації.
  2. fn - (function) Функція для перевірки кожного елемента.
  3. bind - (object, optional) Об'єкт для використання як 'this' у функції. Для отримання додаткової інформації див. Function:bind.

Аргумент: fn

Синтаксис:
fn(item, key, object)
Аргументи:
  1. item - (mixed) Поточний елемент у масиві.
  2. key - (mixed) Ключ поточного елемента.
  3. object - (mixed) Справжній масив/об'єкт.

Приклад:

// alerts 'The first day of the week is Sunday', 'The second day of the week is Monday', etc.:
Object.each({first: 'Sunday', second: 'Monday', third: 'Tuesday'}, function(value, key){
    alert('The ' + key + ' day of the week is ' + value);
});

Примітки:

Цей метод є еквівалентом для об'єктів $each з MooTools 1.2.

Function: Object.merge

Об'єднує будь-яку кількість об'єктів рекурсивно без посилань на них або їхні підоб'єкти.

Синтаксис:

var merged = Object.merge(obj1, obj2[, obj3[, ...]]);

Аргументи:

  1. (objects) Будь-яка кількість об'єктів.

Повертає:

  • (object) Об'єкт, створений результатом об'єднання всіх переданих об'єктів.

Приклади:

var obj1 = {a: 0, b: 1};
var obj2 = {c: 2, d: 3};
var obj3 = {a: 4, d: 5};
var merged = Object.merge(obj1, obj2, obj3); // returns {a: 4, b: 1, c: 2, d: 5}, (obj2, and obj3 are unaltered)
 
merged === obj1; // true, obj1 gets altered and returned as merged object
 
var nestedObj1 = {a: {b: 1, c: 1}};
var nestedObj2 = {a: {b: 2}};
var nested = Object.merge(nestedObj1, nestedObj2); // returns: {a: {b: 2, c: 1}}

Function: Object.clone

Повертає копію об'єкта.

Синтаксис:

var clone = Object.clone(obj);

Аргументи:

  1. (obj) Об'єкт для клонування

Повертає:

  • (object) Копія переданого об'єкта

Приклад:

var obj1 = {a: 0, b: 1};
var obj2 = Object.clone(obj1);
 
obj1.a = 42;
alert(obj1.a);  // alerts '42'
alert(obj2.a);  // alerts '0'

Примітки:

Це еквівалент для об'єктів $unlink з MooTools 1.2.

Function: Object.append

Копіює всі властивості з другого переданого об'єкта до першого переданого об'єкта.

Синтаксис:

Object.append(original, extension);

Аргументи:

  1. оригінал - (object) Об'єкт для розширення.
  2. extension - (object) Об'єкт, властивості якого будуть скопійовані до оригіналу.

Повертає:

  • (object) Перший переданий об'єкт, розширений.

Приклади:

var firstObj = {
    name: 'John',
    lastName: 'Doe'
};
var secondObj = {
    age: '20',
    sex: 'male',
    lastName: 'Dorian'
};
Object.append(firstObj, secondObj);
//firstObj is now: {name: 'John', lastName: 'Dorian', age: '20', sex: 'male'};

Примітки:

Цей метод є еквівалентом для об'єктів $extend з MooTools 1.2.

Function: Object.subset

Отримати підмножину об'єкта.

Синтаксис:

Object.subset(object, keys);

Аргументи:

  1. object - (object) Об'єкт.
  2. keys - (array) Масив з ключами.

Повертає:

  • (object) Підмножина Object.

Приклади:

var object = {
    a: 'one',
    b: 'two',
    c: 'three'
};
Object.subset(object, ['a', 'c']); // returns {a: 'one', c: 'three'}

Function: Object.map

Створює новий об'єкт з результатами виклику наданої функції для кожного значення в об'єкті.

Синтаксис:

var mappedObject = Object.map(object, fn[, bind]);

Аргументи:

  1. object - (object) Об'єкт.
  2. fn - (function) Функція для створення елемента Object з елемента поточного.
  3. bind - (object, optional) Об'єкт для використання як 'this' у функції. Для отримання додаткової інформації див. Function:bind.

Аргумент: fn

Синтаксис:
fn(value, key, object)
Аргументи:
  1. value - (mixed) Поточне значення в об'єкті.
  2. key - (string) Ключ поточного значення в об'єкті.
  3. object - (object) Справжній об'єкт.

Повертає:

  • (object) Новий відображений об'єкт.

Приклади:

var myObject = {a: 1, b: 2, c: 3};
var timesTwo = Object.map(myObject, function(value, key){
    return value * 2;
}); // timesTwo now holds an object containing: {a: 2, b: 4, c: 6};

Function: Object.filter

Створює новий об'єкт зі всіма елементами об'єкта, для яких надана фільтруюча функція повертає true.

Синтаксис:

var filteredObject = Object.filter(object, fn[, bind]);

Аргументи:

  1. object - (object) Об'єкт.
  2. fn - (function) Функція для перевірки кожного елемента Object. Цій функції передаються значення та його ключ у Object.
  3. bind - (object, optional) Об'єкт для використання як 'this' у функції. Для отримання додаткової інформації див. Function:bind.

Аргумент: fn

Синтаксис:
fn(value, key, object)
Аргументи:
  1. value - (mixed) Поточне значення в об'єкті.
  2. key - (string) Ключ поточного значення в об'єкті.
  3. object - (object) Справжній об'єкт.

Повертає:

  • (object) Новий відфільтрований об'єкт.

Приклади:

var myObject = {a: 10, b: 20, c: 30};
var biggerThanTwenty = Object.filter(myObject, function(value, key){
    return value > 20;
}); // biggerThanTwenty now holds an object containing: {c: 30}

Function: Object.every

Повертає true, якщо кожне значення в об'єкті задовольняє надану тестувальну функцію.

Синтаксис:

var allPassed = Object.every(object, fn[, bind]);

Аргументи:

  1. object - (object) Об'єкт.
  2. fn - (function) Функція для перевірки кожного елемента Object. Цій функції передаються значення та його ключ у Object.
  3. bind - (object, optional) Об'єкт для використання як 'this' у функції. Для отримання додаткової інформації див. Function:bind.

Аргумент: fn

Синтаксис:
fn(value, key, object)
Аргументи:
  1. value - (mixed) Поточне значення в об'єкті.
  2. key - (string) Ключ поточного значення в об'єкті.
  3. object - (object) Справжній об'єкт.

Повертає:

  • (boolean) Якщо кожне значення в Object задовольняє надану тестувальну функцію, повертає true. Інакше повертає false.

Приклади:

var myObject = {a: 10, b: 4, c: 25, d: 100};
var areAllBigEnough = Object.every(myObject, function(value, key){
    return value > 20;
}); // areAllBigEnough = false

Function: Object.some

Повертає true, якщо принаймні одне значення в об'єкті задовольняє надану тестувальну функцію.

Синтаксис:

var anyPassed = Object.some(object, fn[, bind]);

Аргументи:

  1. object - (object) Об'єкт.
  2. fn - (function) Функція для перевірки кожного елемента об'єкта. Цій функції передаються значення та його ключ у об'єкті.
  3. bind - (object, optional) Об'єкт для використання як 'this' у функції. Для отримання додаткової інформації див. Function:bind.

Аргумент: fn

Синтаксис:
fn(value, key, object)
Аргументи:
  1. value - (mixed) Поточне значення в об'єкті.
  2. key - (string) Ключ поточного значення в об'єкті.
  3. object - (object) Справжній об'єкт.

Повертає:

  • (boolean) Якщо будь-яке значення в об'єкті задовольняє надану тестувальну функцію, повертає true. Інакше повертає false.

Приклади:

var myObject = {a: 10, b: 4, c: 25, d: 100};
var areAnyBigEnough = Object.some(myObject, function(value, key){
    return value > 20;
}); //isAnyBigEnough = true

Function: Object.keys

Повертає масив, що містить всі ключі, в тому ж порядку, що й значення, повернені Object:values.

Синтаксис:

var keys = Object.keys(object);

Аргументи:

  1. object - (object) Об'єкт.

Повертає:

  • (array) Масив, що містить всі ключі об'єкта.

Function: Object.values

Повертає масив, що містить всі значення, в тому ж порядку, що й ключі, повернені Object:keys.

Синтаксис:

var values = Object.values(object);

Аргументи:

  1. object - (object) Об'єкт.

Повертає:

  • (array) Масив, що містить всі значення об'єкта.

Function: Object.getLength

Повертає кількість ключів у об'єкті.

Синтаксис:

var length = Object.getLength(object);

Аргументи:

  1. object - (object) Об'єкт.

Повертає:

  • (number) Довжина об'єкта.

Приклади:

var myObject = {
    name: 'John',
    lastName: 'Doe'
});
Object.getLength(myObject); // returns 2

Function: Object.keyOf

Повертає ключ зазначеного значення. Синонім Array:indexOf.

Синтаксис:

var key = Object.keyOf(object, item);

Аргументи:

  1. object - (object) Об'єкт.
  2. item - (mixed) Елемент для пошуку в об'єкті.

Повертає:

© Linux.ria.com, 2008-2026