No description
Find a file
Igor Minar 5dc35b527b fix($parse): deprecate promise unwrapping and make it an opt-in
This commit disables promise unwrapping and adds
$parseProvider.unwrapPromises() getter/setter api that allows developers
to turn the feature back on if needed. Promise unwrapping support will
be removed from Angular in the future and this setting only allows for
enabling it during transitional period.

If the unwrapping is enabled, Angular will log a warning about each
expression that unwraps a promise (to reduce the noise, each expression
is logged only onces). To disable this logging use
`$parseProvider.logPromiseWarnings(false)`.

Previously promises found anywhere in the expression during expression
evaluation would evaluate to undefined while unresolved and to the
fulfillment value if fulfilled.

This is a feature that didn't prove to be wildly useful or popular,
primarily because of the dichotomy between data access in templates
(accessed as raw values) and controller code (accessed as promises).

In most code we ended up resolving promises manually in controllers
or automatically via routing and unifying the model access in this way.

Other downsides of automatic promise unwrapping:

- when building components it's often desirable to receive the
  raw promises
- adds complexity and slows down expression evaluation
- makes expression code pre-generation unattractive due to the
  amount of code that needs to be generated
- makes IDE auto-completion and tool support hard
- adds too much magic

BREAKING CHANGE: $parse and templates in general will no longer
automatically unwrap promises. This feature has been deprecated and
if absolutely needed, it can be reenabled during transitional period
via `$parseProvider.unwrapPromises(true)` api.

Closes #4158
Closes #4270
2013-10-09 15:15:43 -07:00
css fix(ngShowHide): change the .ng-hide CSS class to use an !important flag 2013-08-02 23:55:53 -07:00
docs docs(tutorial/step11): correct Jasmine Matcher link 2013-10-09 11:30:22 +01:00
example docs(examples): set ng-app to "personalLog" (example/personalLog) 2013-04-11 14:53:40 -07:00
i18n chore(i18n): update path in the generate.sh script 2013-08-27 15:56:38 -07:00
images chore(Grunt): switch from Rake to Grunt 2013-03-05 23:00:33 -08:00
lib chore(grunt): switch to the new //# sourceMappingURL pragma 2013-10-01 12:30:50 -07:00
logs creating logs/ and tmp/ dirs 2010-10-29 10:47:06 -07:00
src fix($parse): deprecate promise unwrapping and make it an opt-in 2013-10-09 15:15:43 -07:00
test fix($parse): deprecate promise unwrapping and make it an opt-in 2013-10-09 15:15:43 -07:00
.bowerrc chore(bower): add a .bowerrc file 2013-08-07 14:11:23 -07:00
.gitignore chore(tests): add Promises/A+ Test Suite to the build 2013-08-24 12:49:57 -07:00
.travis.yml chore(travis): run bower install twice to make sure it does 2013-08-28 17:48:46 -07:00
angularFiles.js feat($interval): add a service wrapping setInterval 2013-10-07 13:45:40 -07:00
bower.json fix($compile): work around issue in jQuery 1.10.2 2013-09-25 17:25:00 -07:00
changelog.js chore(changelog.js): pickup breaking changes f/ chore/refactor commits 2013-08-13 10:00:14 -07:00
CHANGELOG.md docs(changelog): add a note about directives ending w/ -start and -end 2013-09-05 01:31:34 +02:00
changelog.spec.js chore(changelog.js): improve the changelog script 2013-01-22 22:49:00 -08:00
changelog.tmp.md chore(release scripts): auto release scripts 2012-03-29 07:22:13 -07:00
check-size.sh chore(Grunt): switch from Rake to Grunt 2013-03-05 23:00:33 -08:00
compare-master-to-stable.js chore(release): add script for comparing master and stable branches 2013-09-05 01:15:36 +02:00
CONTRIBUTING.md docs(CONTRIBUTING.md): add contrib info file for GitHub 2012-11-25 21:00:14 +01:00
gdocs.js chore(formating): clean code to be function() { 2011-10-11 11:01:46 -07:00
gen_docs.sh chore(docs): get correct location for jasmine-node 2012-09-06 16:06:25 -07:00
Gruntfile.js fix(build): get promise A+ tests to run on windows 2013-09-17 13:38:52 +01:00
init-repo.sh docs(tutorial): testacular renamed to karma 2013-04-15 12:28:31 +01:00
jenkins_build.sh chore(build): add jenkins_build.sh file 2013-08-30 23:20:30 +02:00
karma-docs.conf.js chore(travis): clean up logs 2013-08-23 16:49:10 -07:00
karma-e2e.conf.js chore(travis): clean up logs 2013-08-23 16:49:10 -07:00
karma-jqlite.conf.js chore(travis): clean up logs 2013-08-23 16:49:10 -07:00
karma-jquery.conf.js chore(travis): clean up logs 2013-08-23 16:49:10 -07:00
karma-modules.conf.js chore(travis): clean up logs 2013-08-23 16:49:10 -07:00
karma-shared.conf.js chore(karma): longer reconnect timeout 2013-08-28 15:46:19 -07:00
LICENSE chore(license): update to google 2012-04-20 11:29:34 -07:00
package.json chore(travis): enable Firefox again 2013-10-08 10:14:03 -07:00
README.md docs(README): add dashboard link 2013-09-09 12:26:22 +01:00
release-commit.sh chore(release scripts): auto release scripts 2012-03-29 07:22:13 -07:00
start-iteration.sh chore(release scripts): auto release scripts 2012-03-29 07:22:13 -07:00
travis_build.sh chore(travis): enable Firefox again 2013-10-08 10:14:03 -07:00
travis_print_logs.sh chore(travis): clean up logs 2013-08-23 16:49:10 -07:00
validate-commit-msg.js docs(validate-commit-msg): fix incorrect comment 2013-06-04 20:23:51 +01:00
validate-commit-msg.spec.js fix(git-validator): support fixup and better errors 2013-01-17 23:52:46 -08:00
watchr-docs.rb chore(watchr): watchr scripts should output logs to terminal 2011-10-31 11:34:25 -07:00

AngularJS Build Status

AngularJS lets you write client-side web applications as if you had a smarter browser. It lets you use good old HTML (or HAML, Jade and friends!) as your template language and lets you extend HTMLs syntax to express your applications components clearly and succinctly. It automatically synchronizes data from your UI (view) with your JavaScript objects (model) through 2-way data binding. To help you structure your application better and make it easy to test, AngularJS teaches the browser how to do dependency injection and inversion of control. Oh yeah and it also helps with server-side communication, taming async callbacks with promises and deferreds; and make client-side navigation and deeplinking with hashbang urls or HTML5 pushState a piece of cake. The best of all: it makes development fun!

Building AngularJS

Once you have your environment setup just run:

grunt package

Running Tests

To execute all unit tests, use:

grunt test:unit

To execute end-to-end (e2e) tests, use:

grunt package
grunt test:e2e

To learn more about the grunt tasks, run grunt --help and also read our contribution guidelines.