+ Ext.Error.ignore = true;
+
+ * @markdown
+ * @static
+ */
+ ignore: false,
+
+<span id='Ext-Error-property-notify'> /**
+</span> * @property notify
+Static flag that can be used to globally control error notification to the user. Unlike
+Ex.Error.ignore, this does not effect exceptions. They are still thrown. This value can be
+set to false to disable the alert notification (default is true for IE6 and IE7).
+
+Only the first error will generate an alert. Internally this flag is set to false when the
+first error occurs prior to displaying the alert.
+
+This flag is not used in a release build.
+
+#Example usage:#
+
+ Ext.Error.notify = false;
+
+ * @markdown
+ * @static
+ */
+ //notify: Ext.isIE6 || Ext.isIE7,
+
+<span id='Ext-Error-method-raise'> /**
+</span>Raise an error that can include additional data and supports automatic console logging if available.
+You can pass a string error message or an object with the `msg` attribute which will be used as the
+error message. The object can contain any other name-value attributes (or objects) to be logged
+along with the error.
+
+Note that after displaying the error message a JavaScript error will ultimately be thrown so that
+execution will halt.
+
+#Example usage:#
+
+ Ext.Error.raise('A simple string error message');
+
+ // or...
+
+ Ext.define('Ext.Foo', {
+ doSomething: function(option){
+ if (someCondition === false) {
+ Ext.Error.raise({
+ msg: 'You cannot do that!',
+ option: option, // whatever was passed into the method
+ 'error code': 100 // other arbitrary info
+ });
+ }
+ }
+ });
+ * @param {String/Object} err The error message string, or an object containing the
+ * attribute "msg" that will be used as the error message. Any other data included in
+ * the object will also be logged to the browser console, if available.
+ * @static
+ * @markdown
+ */
+ raise: function(err){
+ err = err || {};
+ if (Ext.isString(err)) {
+ err = { msg: err };
+ }
+
+ var method = this.raise.caller;
+
+ if (method) {
+ if (method.$name) {
+ err.sourceMethod = method.$name;
+ }
+ if (method.$owner) {
+ err.sourceClass = method.$owner.$className;
+ }
+ }
+
+ if (Ext.Error.handle(err) !== true) {
+ var msg = Ext.Error.prototype.toString.call(err);
+
+ Ext.log({
+ msg: msg,
+ level: 'error',
+ dump: err,
+ stack: true
+ });
+
+ throw new Ext.Error(err);
+ }
+ },
+
+<span id='Ext-Error-method-handle'> /**
+</span>Globally handle any Ext errors that may be raised, optionally providing custom logic to
+handle different errors individually. Return true from the function to bypass throwing the
+error to the browser, otherwise the error will be thrown and execution will halt.
+
+#Example usage:#
+
+ Ext.Error.handle = function(err) {
+ if (err.someProperty == 'NotReallyAnError') {
+ // maybe log something to the application here if applicable
+ return true;
+ }
+ // any non-true return value (including none) will cause the error to be thrown
+ }
+
+ * @param {Ext.Error} err The Ext.Error object being raised. It will contain any attributes
+ * that were originally raised with it, plus properties about the method and class from which
+ * the error originated (if raised from a class that uses the Ext 4 class system).
+ * @static
+ * @markdown
+ */
+ handle: function(){
+ return Ext.Error.ignore;
+ }
git.ithinksw.org / extjs.git / blobdiff