docs(ngModel): rename $asyncValidators error to nopromise and add missing error page

gkalpak · gkalpak · commit bba600414784 · 2016-01-19T16:11:44.000+02:00
Closes angular#13795
diff --git a/docs/content/error/ngModel/nopromise.ngdoc b/docs/content/error/ngModel/nopromise.ngdoc
@@ -0,0 +1,28 @@
+@ngdoc error
+@name ngModel:nopromise
+@fullName No promise
+@description
+
+The return value of an async validator, must always be a promise. If you want to return a
+non-promise value, you can convert it to a promise using {@link ng.$q#resolve `$q.resolve()`} or
+{@link ng.$q#reject `$q.reject()`}.
+
+Example:
+
+```
+.directive('asyncValidator', function($q) {
+  return {
+    require: 'ngModel',
+    link: function(scope, elem, attrs, ngModel) {
+      ngModel.$asyncValidators.myAsyncValidation = function(modelValue, viewValue) {
+        if (/* I don't need to hit the backend API */) {
+          return $q.resolve();     // to mark as valid or
+          // return $q.reject();   // to mark as invalid
+        } else {
+          // ...send a request to the backend and return a promise
+        }
+      };
+    }
+  };
+})
+```
diff --git a/src/ng/directive/ngModel.js b/src/ng/directive/ngModel.js
@@ -596,7 +596,7 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
       forEach(ctrl.$asyncValidators, function(validator, name) {
         var promise = validator(modelValue, viewValue);
         if (!isPromiseLike(promise)) {
-          throw ngModelMinErr("$asyncValidators",
+          throw ngModelMinErr('nopromise',
             "Expected asynchronous validator to return a promise but got '{0}' instead.", promise);
         }
         setValidity(name, undefined);
diff --git a/test/ng/directive/ngModelSpec.js b/test/ng/directive/ngModelSpec.js
@@ -904,7 +904,7 @@ describe('ngModel', function() {
 
         expect(function() {
           scope.$apply('value = "123"');
-        }).toThrowMinErr("ngModel", "$asyncValidators",
+        }).toThrowMinErr("ngModel", "nopromise",
           "Expected asynchronous validator to return a promise but got 'true' instead.");
       }));
 

Original file line number	Diff line number	Diff line change
`@@ -596,7 +596,7 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$`
`596`	`596`	`forEach(ctrl.$asyncValidators, function(validator, name) {`
`597`	`597`	`var promise = validator(modelValue, viewValue);`
`598`	`598`	`if (!isPromiseLike(promise)) {`
`599`		`- throw ngModelMinErr("$asyncValidators",`
	`599`	`+ throw ngModelMinErr('nopromise',`
`600`	`600`	`"Expected asynchronous validator to return a promise but got '{0}' instead.", promise);`
`601`	`601`	`}`
`602`	`602`	`setValidity(name, undefined);`