| Язык версии: | 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():intmessage | свойство |
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
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства