dist/ember-runtime.js in ember-source-1.11.0.beta.2.2 vs dist/ember-runtime.js in ember-source-1.11.0.beta.3
- old
+ new
@@ -3,11 +3,11 @@
* @copyright Copyright 2011-2015 Tilde Inc. and contributors
* Portions Copyright 2006-2011 Strobe Inc.
* Portions Copyright 2008-2011 Apple Inc. All rights reserved.
* @license Licensed under MIT license
* See https://raw.github.com/emberjs/ember.js/master/LICENSE
- * @version 1.11.0-beta.2
+ * @version 1.11.0-beta.3.780ac356
*/
(function() {
var enifed, requireModule, eriuqer, requirejs, Ember;
var mainContext = this;
@@ -4110,12 +4110,14 @@
fullName: function () {
return this.get('firstName') + ' ' + this.get('lastName');
}.property('firstName', 'lastName')
```
- @method computed
- @for Ember
+ @class computed
+ @namespace Ember
+ @constructor
+ @static
@param {String} [dependentKeys*] Optional dependent keys that trigger this computed property.
@param {Function} func The computed property function.
@return {Ember.ComputedProperty} property descriptor instance
*/
function computed(func) {
@@ -4248,12 +4250,12 @@
todoList.get('todos').clear();
todoList.get('isDone'); // true
```
@since 1.6.0
- @method computed.empty
- @for Ember
+ @method empty
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which negate
the original value for property
*/
function empty(dependentKey) {
@@ -4278,12 +4280,12 @@
hamster.get('hasStuff'); // true
hamster.get('backpack').clear(); // []
hamster.get('hasStuff'); // false
```
- @method computed.notEmpty
- @for Ember
+ @method notEmpty
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which returns true if
original value for property is not empty.
*/
function notEmpty(dependentKey) {
@@ -4311,12 +4313,12 @@
hamster.get('isHungry'); // false
hamster.set('food', null);
hamster.get('isHungry'); // true
```
- @method computed.none
- @for Ember
+ @method none
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which
returns true if original value for property is null or undefined.
*/
function none(dependentKey) {
@@ -4341,12 +4343,12 @@
user.get('isAnonymous'); // true
user.set('loggedIn', true);
user.get('isAnonymous'); // false
```
- @method computed.not
- @for Ember
+ @method not
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which returns
inverse of the original value for property
*/
function not(dependentKey) {
@@ -4373,12 +4375,12 @@
hamster.get('hasBananas'); // true
hamster.set('numBananas', null);
hamster.get('hasBananas'); // false
```
- @method computed.bool
- @for Ember
+ @method bool
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which converts
to boolean the original value for property
*/
function bool(dependentKey) {
@@ -4406,12 +4408,12 @@
user.get('hasValidEmail'); // false
user.set('email', 'ember_hamster@example.com');
user.get('hasValidEmail'); // true
```
- @method computed.match
- @for Ember
+ @method match
+ @for Ember.computed
@param {String} dependentKey
@param {RegExp} regexp
@return {Ember.ComputedProperty} computed property which match
the original value for property against a given RegExp
*/
@@ -4441,12 +4443,12 @@
hamster.get('napTime'); // true
hamster.set('state', 'hungry');
hamster.get('napTime'); // false
```
- @method computed.equal
- @for Ember
+ @method equal
+ @for Ember.computed
@param {String} dependentKey
@param {String|Number|Object} value
@return {Ember.ComputedProperty} computed property which returns true if
the original value for property is equal to the given value.
*/
@@ -4474,12 +4476,12 @@
hamster.get('hasTooManyBananas'); // false
hamster.set('numBananas', 11);
hamster.get('hasTooManyBananas'); // true
```
- @method computed.gt
- @for Ember
+ @method gt
+ @for Ember.computed
@param {String} dependentKey
@param {Number} value
@return {Ember.ComputedProperty} computed property which returns true if
the original value for property is greater than given value.
*/
@@ -4507,12 +4509,12 @@
hamster.get('hasTooManyBananas'); // false
hamster.set('numBananas', 10);
hamster.get('hasTooManyBananas'); // true
```
- @method computed.gte
- @for Ember
+ @method gte
+ @for Ember.computed
@param {String} dependentKey
@param {Number} value
@return {Ember.ComputedProperty} computed property which returns true if
the original value for property is greater or equal then given value.
*/
@@ -4540,12 +4542,12 @@
hamster.get('needsMoreBananas'); // false
hamster.set('numBananas', 2);
hamster.get('needsMoreBananas'); // true
```
- @method computed.lt
- @for Ember
+ @method lt
+ @for Ember.computed
@param {String} dependentKey
@param {Number} value
@return {Ember.ComputedProperty} computed property which returns true if
the original value for property is less then given value.
*/
@@ -4573,12 +4575,12 @@
hamster.get('needsMoreBananas'); // false
hamster.set('numBananas', 3);
hamster.get('needsMoreBananas'); // true
```
- @method computed.lte
- @for Ember
+ @method lte
+ @for Ember.computed
@param {String} dependentKey
@param {Number} value
@return {Ember.ComputedProperty} computed property which returns true if
the original value for property is less or equal than given value.
*/
@@ -4608,12 +4610,12 @@
hamster.get('readyForCamp'); // true
hamster.set('hasBackpack', 'Yes');
hamster.get('readyForCamp'); // 'Yes'
```
- @method computed.and
- @for Ember
+ @method and
+ @for Ember.computed
@param {String} dependentKey*
@return {Ember.ComputedProperty} computed property which performs
a logical `and` on the values of all the original values for properties.
*/
var and = generateComputedWithProperties(function(properties) {
@@ -4645,12 +4647,12 @@
hamster.get('readyForRain'); // true
hamster.set('hasJacket', 'Yes');
hamster.get('readyForRain'); // 'Yes'
```
- @method computed.or
- @for Ember
+ @method or
+ @for Ember.computed
@param {String} dependentKey*
@return {Ember.ComputedProperty} computed property which performs
a logical `or` on the values of all the original values for properties.
*/
var or = generateComputedWithProperties(function(properties) {
@@ -4678,12 +4680,12 @@
hamster.get('hasClothes'); // null
hamster.set('shirt', 'Hawaiian Shirt');
hamster.get('hasClothes'); // 'Hawaiian Shirt'
```
- @method computed.any
- @for Ember
+ @method any
+ @for Ember.computed
@param {String} dependentKey*
@return {Ember.ComputedProperty} computed property which returns
the first truthy value of given list of properties.
@deprecated Use `Ember.computed.or` instead.
*/
@@ -4713,12 +4715,12 @@
hamster.set('hat', 'Camp Hat');
hamster.set('shirt', 'Camp Shirt');
hamster.get('clothes'); // ['Camp Hat', 'Camp Shirt']
```
- @method computed.collect
- @for Ember
+ @method collect
+ @for Ember.computed
@param {String} dependentKey*
@return {Ember.ComputedProperty} computed property which maps
values of all passed in properties to an array.
*/
var collect = generateComputedWithProperties(function(properties) {
@@ -4753,12 +4755,12 @@
alex.set('nomen', '@machty');
alex.get('name'); // '@machty'
```
- @method computed.alias
- @for Ember
+ @method alias
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which creates an
alias to the original value for property.
*/
@@ -4786,12 +4788,12 @@
teddy.get('nickName'); // 'Teddy'
teddy.set('nickName', 'TeddyBear'); // 'TeddyBear'
teddy.get('firstName'); // 'Teddy'
```
- @method computed.oneWay
- @for Ember
+ @method oneWay
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which creates a
one way computed property to the original value for property.
*/
function oneWay(dependentKey) {
@@ -4834,12 +4836,12 @@
teddy.set('nickName', 'TeddyBear'); // throws Exception
// throw new Ember.Error('Cannot Set: nickName on: <User:ember27288>' );`
teddy.get('firstName'); // 'Teddy'
```
- @method computed.readOnly
- @for Ember
+ @method readOnly
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which creates a
one way computed property to the original value for property.
@since 1.5.0
*/
@@ -4865,12 +4867,12 @@
hamster.set('wishList', 'More Unit Tests');
hamster.get('wishList'); // 'More Unit Tests'
hamster.get('favoriteFood'); // 'Banana'
```
- @method computed.defaultTo
- @for Ember
+ @method defaultTo
+ @for Ember.computed
@param {String} defaultPath
@return {Ember.ComputedProperty} computed property which acts like
a standard getter and setter, but defaults to the value from `defaultPath`.
@deprecated Use `Ember.computed.oneWay` or custom CP with default instead.
*/
@@ -4888,12 +4890,12 @@
Creates a new property that is an alias for another property
on an object. Calls to `get` or `set` this property behave as
though they were called on the original property, but also
print a deprecation warning.
- @method computed.deprecatingAlias
- @for Ember
+ @method deprecatingAlias
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computed property which creates an
alias with a deprecation to the original value for property.
@since 1.7.0
*/
@@ -4943,11 +4945,11 @@
The core Runtime framework is based on the jQuery API with a number of
performance optimizations.
@class Ember
@static
- @version 1.11.0-beta.2
+ @version 1.11.0-beta.3.780ac356
*/
if ('undefined' === typeof Ember) {
// Create core object. Make it act like an instance of Ember.Namespace so that
// objects assigned to it are given a sane string representation.
@@ -4971,14 +4973,14 @@
/**
@property VERSION
@type String
- @default '1.11.0-beta.2'
+ @default '1.11.0-beta.3.780ac356'
@static
*/
- Ember.VERSION = '1.11.0-beta.2';
+ Ember.VERSION = '1.11.0-beta.3.780ac356';
/**
Standard environmental variables. You can define these in a global `EmberENV`
variable before loading Ember to control various configuration settings.
@@ -12987,12 +12989,12 @@
/**
A computed property that returns the sum of the value
in the dependent array.
- @method computed.sum
- @for Ember
+ @method sum
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computes the sum of all values in the dependentKey's array
@since 1.4.0
*/
@@ -13036,12 +13038,12 @@
age: 8
}]);
lordByron.get('maxChildAge'); // 8
```
- @method computed.max
- @for Ember
+ @method max
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computes the largest value in the dependentKey's array
*/
function max(dependentKey) {
return reduce_computed.reduceComputed(dependentKey, {
@@ -13085,12 +13087,12 @@
age: 8
}]);
lordByron.get('minChildAge'); // 5
```
- @method computed.min
- @for Ember
+ @method min
+ @for Ember.computed
@param {String} dependentKey
@return {Ember.ComputedProperty} computes the smallest value in the dependentKey's array
*/
function min(dependentKey) {
return reduce_computed.reduceComputed(dependentKey, {
@@ -13133,12 +13135,12 @@
});
hamster.get('excitingChores'); // ['CLEAN!', 'WRITE MORE UNIT TESTS!']
```
- @method computed.map
- @for Ember
+ @method map
+ @for Ember.computed
@param {String} dependentKey
@param {Function} callback
@return {Ember.ComputedProperty} an array mapped via the callback
*/
function map(dependentKey, callback) {
@@ -13178,24 +13180,24 @@
age: 8
}]);
lordByron.get('childAges'); // [7, 5, 8]
```
- @method computed.mapBy
- @for Ember
+ @method mapBy
+ @for Ember.computed
@param {String} dependentKey
@param {String} propertyKey
@return {Ember.ComputedProperty} an array mapped to the specified key
*/
function mapBy(dependentKey, propertyKey) {
var callback = function(item) { return property_get.get(item, propertyKey); };
return map(dependentKey + '.@each.' + propertyKey, callback);
}
/**
- @method computed.mapProperty
- @for Ember
+ @method mapProperty
+ @for Ember.computed
@deprecated Use `Ember.computed.mapBy` instead
@param dependentKey
@param propertyKey
*/
var mapProperty = mapBy;
@@ -13228,12 +13230,12 @@
});
hamster.get('remainingChores'); // [{name: 'write more unit tests', done: false}]
```
- @method computed.filter
- @for Ember
+ @method filter
+ @for Ember.computed
@param {String} dependentKey
@param {Function} callback
@return {Ember.ComputedProperty} the filtered array
*/
function filter(dependentKey, callback) {
@@ -13284,12 +13286,12 @@
});
hamster.get('remainingChores'); // [{ name: 'write more unit tests', done: false }]
```
- @method computed.filterBy
- @for Ember
+ @method filterBy
+ @for Ember.computed
@param {String} dependentKey
@param {String} propertyKey
@param {*} value
@return {Ember.ComputedProperty} the filtered array
*/
@@ -13308,12 +13310,12 @@
return filter(dependentKey + '.@each.' + propertyKey, callback);
}
/**
- @method computed.filterProperty
- @for Ember
+ @method filterProperty
+ @for Ember.computed
@param dependentKey
@param propertyKey
@param value
@deprecated Use `Ember.computed.filterBy` instead
*/
@@ -13340,12 +13342,12 @@
});
hamster.get('uniqueFruits'); // ['banana', 'grape', 'kale']
```
- @method computed.uniq
- @for Ember
+ @method uniq
+ @for Ember.computed
@param {String} propertyKey*
@return {Ember.ComputedProperty} computes a new array with all the
unique elements from the dependent array
*/
function uniq() {
@@ -13384,12 +13386,12 @@
}
/**
Alias for [Ember.computed.uniq](/api/#method_computed_uniq).
- @method computed.union
- @for Ember
+ @method union
+ @for Ember.computed
@param {String} propertyKey*
@return {Ember.ComputedProperty} computes a new array with all the
unique elements from the dependent array
*/
var union = uniq;
@@ -13408,12 +13410,12 @@
});
obj.get('friendsInCommon'); // ['William King', 'Mary Somerville']
```
- @method computed.intersect
- @for Ember
+ @method intersect
+ @for Ember.computed
@param {String} propertyKey*
@return {Ember.ComputedProperty} computes a new array with all the
duplicated elements from the dependent arrays
*/
function intersect() {
@@ -13495,12 +13497,12 @@
});
hamster.get('wants'); // ['banana']
```
- @method computed.setDiff
- @for Ember
+ @method setDiff
+ @for Ember.computed
@param {String} setAProperty
@param {String} setBProperty
@return {Ember.ComputedProperty} computes a new array with all the
items from the first dependent array that are not in the second
dependent array
@@ -13639,11 +13641,11 @@
todoList.get('sortedTodos'); // [{ name:'Documentation', priority:3 }, { name:'Release', priority:1 }, { name:'Unit Test', priority:2 }]
todoList.get('sortedTodosDesc'); // [{ name:'Unit Test', priority:2 }, { name:'Release', priority:1 }, { name:'Documentation', priority:3 }]
todoList.get('priorityTodos'); // [{ name:'Release', priority:1 }, { name:'Unit Test', priority:2 }, { name:'Documentation', priority:3 }]
```
- @method computed.sort
- @for Ember
+ @method sort
+ @for Ember.computed
@param {String} dependentKey
@param {String or Function} sortDefinition a dependent key to an
array of sort properties (add `:desc` to the arrays sort properties to sort descending) or a function to use when sorting
@return {Ember.ComputedProperty} computes a new sorted array based
on the sort property array or callback function