A collection of useful static methods to deal with objects
-Iterate through an object and invoke the given callback function for each iteration. The iteration can be stop
-by returning false in the callback function. For example:
var person = {
- name: 'Jacky'
- hairColor: 'black'
- loves: ['food', 'sleeping', 'wife']
-};
-
-Ext.Object.each(person, function(key, value, myself) {
- console.log(key + ":" + value);
-
- if (key === 'hairColor') {
- return false; // stop the iteration
- }
-});
-The object to iterate
-The callback function. Passed arguments for each iteration are:
- -keyvalueobject The object itself(Optional) The execution scope (this) of the callback function
Converts a query string back into an object.
- -Non-recursive:
- -Ext.Object.fromQueryString(foo=1&bar=2); // returns {foo: 1, bar: 2} - Ext.Object.fromQueryString(foo=&bar=2); // returns {foo: null, bar: 2} - Ext.Object.fromQueryString(some%20price=%24300); // returns {'some price': '$300'} - Ext.Object.fromQueryString(colors=red&colors=green&colors=blue); // returns {colors: ['red', 'green', 'blue']}
Recursive:
- -Ext.Object.fromQueryString("username=Jacky&dateOfBirth[day]=1&dateOfBirth[month]=2&dateOfBirth[year]=1911&hobbies[0]=coding&hobbies[1]=eating&hobbies[2]=sleeping&hobbies[3][0]=nested&hobbies[3][1]=stuff", true);
- -// returns - {
- - username: 'Jacky',
- dateOfBirth: {
- day: '1',
- month: '2',
- year: '1911'
- },
- hobbies: ['coding', 'eating', 'sleeping', ['nested', 'stuff']]
-}
The query string to decode
-(Optional) Whether or not to recursively decode the string. This format is supported by -PHP / Ruby on Rails servers and similar. Defaults to false
-Returns the first matching key corresponding to the given value. -If no matching value is found, null is returned.
- -var person = {
- name: 'Jacky',
- loves: 'food'
-};
-
-alert(Ext.Object.getKey(sencha, 'loves')); // alerts 'food'
-The value to find
-Gets the total number of this object's own properties
- -var size = Ext.Object.getSize({
- name: 'Jacky',
- loves: 'food'
-}); // size equals 2
-size
-Gets all values of the given object as an array.
- -var values = Ext.Object.getValues({
- name: 'Jacky',
- loves: 'food'
-}); // ['Jacky', 'food']
-An array of values from the object
-Merges any number of objects recursively without referencing them or their children.
- -var extjs = {
- companyName: 'Ext JS',
- products: ['Ext JS', 'Ext GWT', 'Ext Designer'],
- isSuperCool: true
- office: {
- size: 2000,
- location: 'Palo Alto',
- isFun: true
- }
-};
-
-var newStuff = {
- companyName: 'Sencha Inc.',
- products: ['Ext JS', 'Ext GWT', 'Ext Designer', 'Sencha Touch', 'Sencha Animator'],
- office: {
- size: 40000,
- location: 'Redwood City'
- }
-};
-
-var sencha = Ext.Object.merge(extjs, newStuff);
-
-// extjs and sencha then equals to
-{
- companyName: 'Sencha Inc.',
- products: ['Ext JS', 'Ext GWT', 'Ext Designer', 'Sencha Touch', 'Sencha Animator'],
- isSuperCool: true
- office: {
- size: 30000,
- location: 'Redwood City'
- isFun: true
- }
-}
-,...
-merged The object that is created as a result of merging all the objects passed in.
-Convert a name - value pair to an array of objects with support for nested structures; useful to construct
-query strings. For example:
var objects = Ext.Object.toQueryObjects('hobbies', ['reading', 'cooking', 'swimming']);
-
-// objects then equals:
-[
- { name: 'hobbies', value: 'reading' },
- { name: 'hobbies', value: 'cooking' },
- { name: 'hobbies', value: 'swimming' },
-];
-
-var objects = Ext.Object.toQueryObjects('dateOfBirth', {
- day: 3,
- month: 8,
- year: 1987,
- extra: {
- hour: 4
- minute: 30
- }
-}, true); // Recursive
-
-// objects then equals:
-[
- { name: 'dateOfBirth[day]', value: 3 },
- { name: 'dateOfBirth[month]', value: 8 },
- { name: 'dateOfBirth[year]', value: 1987 },
- { name: 'dateOfBirth[extra][hour]', value: 4 },
- { name: 'dateOfBirth[extra][minute]', value: 30 },
-];
-Takes an object and converts it to an encoded query string
- -Non-recursive:
- -Ext.Object.toQueryString({foo: 1, bar: 2}); // returns "foo=1&bar=2" - Ext.Object.toQueryString({foo: null, bar: 2}); // returns "foo=&bar=2" - Ext.Object.toQueryString({'some price': '$300'}); // returns "some%20price=%24300" - Ext.Object.toQueryString({date: new Date(2011, 0, 1)}); // returns "date=%222011-01-01T00%3A00%3A00%22" - Ext.Object.toQueryString({colors: ['red', 'green', 'blue']}); // returns "colors=red&colors=green&colors=blue"
Recursive:
- -Ext.Object.toQueryString({
- - username: 'Jacky',
- dateOfBirth: {
- day: 1,
- month: 2,
- year: 1911
- },
- hobbies: ['coding', 'eating', 'sleeping', ['nested', 'stuff']]
- // username=Jacky
- // &dateOfBirth[day]=1&dateOfBirth[month]=2&dateOfBirth[year]=1911
- // &hobbies[0]=coding&hobbies[1]=eating&hobbies[2]=sleeping&hobbies[3][0]=nested&hobbies[3][1]=stuff
-The object to encode
-(optional) Whether or not to interpret the object in recursive format. -(PHP / Ruby on Rails servers and similar). Defaults to false
-queryString
-