new Cesium.TileProviderError(provider, message, x, y, level, timesRetried, error)
提供有关在
ImageryProvider
或TerrainProvider
中发生的错误的详细信息。
Name | Type | Default | Description |
---|---|---|---|
provider |
ImageryProvider | TerrainProvider | 出现错误的图像或地形提供器。 | |
message |
String | 描述错误的消息。 | |
x |
Number | optional 出现错误的瓦片的X坐标,如果错误不是特定于某个瓦片,则为undefined。 | |
y |
Number | optional 出现错误的瓦片的Y坐标,如果错误不是特定于某个瓦片,则为undefined。 | |
level |
Number | optional 发生错误的瓦片的级别,如果错误不是特定于某个瓦片,则为undefined。 | |
timesRetried |
Number |
0
|
optional 此操作被重试的次数。 |
error |
Error | optional 发生的错误或异常(如果有的话)。 |
成员变量
error : Error
发生的错误或异常(如果有的话)。
level : Number
发生错误的瓦片的级别,如果错误不是特定于某个瓦片,则为undefined。
message : String
描述错误的消息。
retry : Boolean
如果要重试失败的操作,则为true;否则,false。
图像或地形提供器将在引发事件之前设置此属性的初始值,但是任何监听器都可以更改它。
最后一个监听器调用后的值将被处理。
-
Default Value:
false
timesRetried : Number
此操作被重试的次数。
-
Default Value:
0
x : Number
出现错误的瓦片的X坐标,如果错误不是特定于某个瓦片,则为undefined。
y : Number
出现错误的瓦片的Y坐标,如果错误不是特定于某个瓦片,则为undefined。
内置方法
staticCesium.TileProviderError.handleError(previousError, provider, event, message, x, y, level, retryFunction, errorDetails) → TileProviderError
处理由
ImageryProvider
或TerrainProvider
的任何监听器引发的事件中的错误,如果事件没有侦听器,则将错误记录到控制台。
此方法还跟踪操作重试的次数,如果事件监听器请求重试,则会自动重试。
Name | Type | Description |
---|---|---|
previousError |
TileProviderError | 此函数返回的错误实例是最后一次调用它时返回的此错误,如果这是第一次发生此错误,则返回未定义的错误实例。 |
provider |
ImageryProvider | TerrainProvider | 遇到错误的图像或地形提供器。 |
event |
Event | 事件,以将错误通知监听器。 |
message |
String | 描述错误的消息。 |
x |
Number | 出现错误的瓦片的X坐标,如果错误不是特定于某个瓦片,则为undefined。 |
y |
Number | 出现错误的瓦片的Y坐标,如果错误不是特定于某个瓦片,则为undefined。 |
level |
Number | 发生错误的瓦片的详细级别,如果错误不是特定于某个瓦片,则为undefined。 |
retryFunction |
TileProviderError~RetryFunction | 要调用的函数以重试操作。如果未定义,则不会重试操作。 |
errorDetails |
Error | optional 发生的错误或异常(如果有的话)。 |
返回值:
传递给事件监听器的错误实例,下次为跟踪重试计数而调用该函数时,应该将该实例传递给该函数。
通过重置前一个错误(如果有)的重试计数来处理操作的成功。
这样,如果将来错误再次发生,监听器将被告知尚未重试。
Name | Type | Description |
---|---|---|
previousError |
TileProviderError | 前一个错误,如果此操作之前没有导致错误,则为未定义。 |
类型定义
RetryFunction()
将被调用以重试操作的函数。