Deprecated
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The ProgressEvent.initProgressEvent()
method Initializes an animation event created using the deprecated Document.createEvent("ProgressEvent")
method.
ProgressEvent
created that way are untrusted.
Note: this method has been dropped during the standard process. It has been deprecated and removed from most implementation. Do not use it anymore, use the standard constructor, ProgressEvent()
, to create a synthetic ProgressEvent
Syntax
Progress.initProgressEvent(typeArg, canBubbleArg, cancelableArg, lengthComputable, loaded, total);
Parameters
- typeArg
- Is a
DOMString
identifying the specific type of animation event that occurred. The following values are allowed:Value Meaning loadstart
The operation has started. progress
The operation still is in progress. error
The operation failed and didn't complete. abort
The operation was cancelled and didn't complete. load
The operation completed. loadend
The operation stopped. - canBubbleArg
- Is a
Boolean
flag indicating if the event can bubble (true
) or not (false)
. - cancelableArg
- Is a
Boolean
flag indicating if the event associated action can be avoided (true
) or not (false)
. - lengthComputable
- Is a
Boolean
flag indicating if the total work to be done, and the amount of work already done, by the underlying process is calculable. In other words, it tells if the progress is measurable or not. - loaded
- Is an
unsigned long long
representing the amount of work already performed by the underlying process. The ratio of work done can be calculated with the property andProgressEvent.total
. When downloading a resource using HTTP, this only represent the part of the content itself, not headers and other overhead. - total
- Is an
unsigned long long
representing the total amount of work that the underlying process is in the progress of performing. When downloading a resource using HTTP, this only represent the content itself, not headers and other overhead.
Specifications
This feature does not exist in any specifications.
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
initProgressEvent | Chrome No support 1 — 17 | Edge No support 12 — 79 | Firefox No support 3.5 — 22 | IE Full support 10 | Opera No support ? — 15 | Safari No support ? — ? | WebView Android No support No | Chrome Android No support ? — ? | Firefox Android No support 4 — 22 | Opera Android No support ? — 14 | Safari iOS No support ? — ? | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Non-standard. Expect poor cross-browser support.
- Non-standard. Expect poor cross-browser support.
- Deprecated. Not for use in new websites.
- Deprecated. Not for use in new websites.
See also
- The
ProgressEvent
interface it belongs to.