Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Error
. Как правило, новый объект Error формируется внутри программного блока try
, а затем регистрируется в программном блоке catch
.
Кроме того, можно создать подкласс класса Error и генерировать экземпляры этого подкласса.
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
errorID : int [только для чтения]
Содержит номер ссылки, связанный с конкретным сообщением об ошибке. | Error | ||
message : String
Содержит сообщение, связанное с объектом Error. | Error | ||
name : String
Содержит имя объекта Error. | Error |
Метод | Определено | ||
---|---|---|---|
Создает новый объект Error. | Error | ||
Возвращает список вызовов для данной ошибки в момент ее конструирования в форме строки. | Error | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
[переопределить]
Возвращает строку Error по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено. | Error | ||
Возвращает элементарное значение заданного объекта. | Object |
errorID | свойство |
errorID:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Содержит номер ссылки, связанный с конкретным сообщением об ошибке. Для пользовательского объекта Error это число является значением параметра id
, представленным в конструкторе.
Реализация
public function get errorID():int
message | свойство |
public var message:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Содержит сообщение, связанное с объектом Error. По умолчанию в качестве значения этого свойства выбрано Error
. Свойство message
можно указать при создании объекта Error, передав строку ошибки функции конструктора Error
.
Связанные элементы API
name | свойство |
public var name:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Содержит имя объекта Error. По умолчанию в качестве значения этого свойства выбрано Error
.
Связанные элементы API
Error | () | Конструктор |
public function Error(message:String = "", id:int = 0)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Создает новый объект Error. Если указано message
, его значение присваивается свойству Error.message
объекта.
message:String (default = " ") — Строка, связанная с объектом Error; этот параметр является необязательным.
| |
id:int (default = 0 ) — Ссылочный номер, связываемый с конкретным сообщением об ошибке.
|
Связанные элементы API
Пример ( Использование этого примера )
err
, а затем с помощью конструктора Error()
строка New Error Message
(«Новое сообщение об ошибке») присваивается err
.
var err:Error = new Error(); trace(err.toString()); // Error err = new Error("New Error Message"); trace(err.toString()); // Error: New Error Message
getStackTrace | () | метод |
public function getStackTrace():String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Возвращает список вызовов для данной ошибки в момент ее конструирования в форме строки. Как показано в следующем примере, первая строка возвращаемого значения представляет собой строковое представление объекта исключения, вслед за которой указываются элементы трассировки стека.
TypeError: Error #1009: Cannot access a property or method of a null object reference at com.xyz::OrderEntry/retrieveData()[/src/com/xyz/OrderEntry.as:995] at com.xyz::OrderEntry/init()[/src/com/xyz/OrderEntry.as:200] at com.xyz::OrderEntry()[/src/com/xyz/OrderEntry.as:148]
В вышеприведенном примере отображается значение этого метода при вызове его в отладочной версии Flash Player или при выполнении кода в AIR Debug Launcher (ADL). При выполнении кода в финальной версии Flash Player или AIR трассировка стека предоставляется без файлового пути и без информации о номере строки, как в следующем примере:
TypeError: Error #1009: Cannot access a property or method of a null object reference at com.xyz::OrderEntry/retrieveData() at com.xyz::OrderEntry/init() at com.xyz::OrderEntry()
В случае Flash Player 11.4 и более ранних версий или AIR 3.4 и более ранних версий, трассировки стека доступны только при выполнении кода в отладочной версии Flash Player или в AIR Debug Launcher (ADL). В неотладочных версиях этих сред выполнения при вызове этого метода будет возвращено значение null
.
String — Строковое представление списка вызовов.
|
toString | () | метод |
override public function toString():String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Возвращает строку Error
по умолчанию или значение, содержащееся в свойстве Error.message
, если оно определено.
String — Сообщение об ошибке.
|
Связанные элементы API
Пример ( Использование этого примера )
err
, а затем с помощью конструктора Error()
строка New Error Message
(«Новое сообщение об ошибке») присваивается err
. В итоге, свойству message
присваивается значение Another New Error Message
(«Еще одно новое сообщение об ошибке»), которое заменяет значение New Error Message
(«Новое сообщение об ошибке»).
var err:Error = new Error(); trace(err.toString()); // Error err = new Error("New Error Message"); trace(err.toString()); // Error: New Error Message err.message = "Another New Error Message"; trace(err.toString()); // Error: Another New Error Message
ErrorExample
, на примере которого демонстрируется процесс генерации пользовательской ошибки. Это можно сделать, выполнив следующие действия:
- Объявляется локальная переменная
nullArray
типа Array, но обратите внимание, что новый объект Array никогда не создается. - Конструктор пытается загрузить значение в неинициализированный массив методом
push()
в сегменте кода для обработки ошибок, который перехватывает пользовательскую ошибку с помощью классаCustomError
, который является расширением классаError
. - При создании класса CustomError конструктор регистрирует его, а затем выдает сообщение об ошибке с помощью выражения
trace()
.
package { import flash.display.Sprite; public class ErrorExample extends Sprite { private var nullArray:Array; public function ErrorExample() { try { nullArray.push("item"); } catch(e:Error) { throw new CustomError("nullArray is null"); } } } } class CustomError extends Error { public function CustomError(message:String) { super(message); } }
Tue Jun 12 2018, 11:34 AM Z