Stores information for making a request. In general this does not need to be constructed directly.
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
optional
An object with the following properties:
|
Members
cancelFunction : Request.CancelCallback
The function that is called when the request is cancelled.
Priority is a unit-less value where lower values represent higher priority.
For world-based objects, this is usually the distance from the camera.
A request that does not have a priority function defaults to a priority of 0.
If priorityFunction is defined, this value is updated every frame with the result of that call.
-
Default Value:
0.0
priorityFunction : Request.PriorityCallback
The function that is called to update the request's priority, which occurs once per frame.
requestFunction : Request.RequestCallback
The function that makes the actual data request.
readonly state : RequestState
The current state of the request.
Whether to throttle and prioritize the request. If false, the request will be sent immediately. If true, the
request will be throttled and sent based on priority.
-
Default Value:
false
Whether to throttle the request by server. Browsers typically support about 6-8 parallel connections
for HTTP/1 servers, and an unlimited amount of connections for HTTP/2 servers. Setting this value
to
true
is preferable for requests going through HTTP/1 servers.
-
Default Value:
false
readonly type : RequestType
Type of request.
-
Default Value:
RequestType.OTHER
The URL to request.
Methods
clone(result) → Request
Duplicates a Request instance.
Name | Type | Description |
---|---|---|
result |
Request | optional The object onto which to store the result. |
Returns:
The modified result parameter or a new Resource instance if one was not provided.
Type Definitions
The function that is called when the request is cancelled.
The function that is called to update the request's priority, which occurs once per frame.
Returns:
The updated priority value.
The function that makes the actual data request.
Returns:
A promise for the requested data.