Use an enum for the ready state of media elements

This commit is contained in:
Anthony Ramine 2017-09-14 14:47:38 +02:00
parent 86b25cd6b5
commit 518e34e7c8

View file

@ -9,7 +9,6 @@ use dom::bindings::cell::DOMRefCell;
use dom::bindings::codegen::Bindings::AttrBinding::AttrMethods; use dom::bindings::codegen::Bindings::AttrBinding::AttrMethods;
use dom::bindings::codegen::Bindings::HTMLMediaElementBinding::CanPlayTypeResult; use dom::bindings::codegen::Bindings::HTMLMediaElementBinding::CanPlayTypeResult;
use dom::bindings::codegen::Bindings::HTMLMediaElementBinding::HTMLMediaElementConstants; use dom::bindings::codegen::Bindings::HTMLMediaElementBinding::HTMLMediaElementConstants;
use dom::bindings::codegen::Bindings::HTMLMediaElementBinding::HTMLMediaElementConstants::*;
use dom::bindings::codegen::Bindings::HTMLMediaElementBinding::HTMLMediaElementMethods; use dom::bindings::codegen::Bindings::HTMLMediaElementBinding::HTMLMediaElementMethods;
use dom::bindings::codegen::Bindings::MediaErrorBinding::MediaErrorConstants::*; use dom::bindings::codegen::Bindings::MediaErrorBinding::MediaErrorConstants::*;
use dom::bindings::codegen::Bindings::MediaErrorBinding::MediaErrorMethods; use dom::bindings::codegen::Bindings::MediaErrorBinding::MediaErrorMethods;
@ -51,7 +50,7 @@ pub struct HTMLMediaElement {
network_state: Cell<NetworkState>, network_state: Cell<NetworkState>,
/// https://html.spec.whatwg.org/multipage/#dom-media-readystate /// https://html.spec.whatwg.org/multipage/#dom-media-readystate
// FIXME(nox): Use an enum. // FIXME(nox): Use an enum.
ready_state: Cell<u16>, ready_state: Cell<ReadyState>,
/// https://html.spec.whatwg.org/multipage/#dom-media-currentsrc /// https://html.spec.whatwg.org/multipage/#dom-media-currentsrc
current_src: DOMRefCell<String>, current_src: DOMRefCell<String>,
// FIXME(nox): Document this one, I have no idea what it is used for. // FIXME(nox): Document this one, I have no idea what it is used for.
@ -81,6 +80,17 @@ enum NetworkState {
NoSource = HTMLMediaElementConstants::NETWORK_NO_SOURCE as u8, NoSource = HTMLMediaElementConstants::NETWORK_NO_SOURCE as u8,
} }
/// https://html.spec.whatwg.org/multipage/#dom-media-readystate
#[derive(Clone, Copy, HeapSizeOf, JSTraceable, PartialEq, PartialOrd)]
#[repr(u8)]
enum ReadyState {
HaveNothing = HTMLMediaElementConstants::HAVE_NOTHING as u8,
HaveMetadata = HTMLMediaElementConstants::HAVE_METADATA as u8,
HaveCurrentData = HTMLMediaElementConstants::HAVE_CURRENT_DATA as u8,
HaveFutureData = HTMLMediaElementConstants::HAVE_FUTURE_DATA as u8,
HaveEnoughData = HTMLMediaElementConstants::HAVE_ENOUGH_DATA as u8,
}
#[derive(HeapSizeOf, JSTraceable)] #[derive(HeapSizeOf, JSTraceable)]
pub struct VideoMedia { pub struct VideoMedia {
format: String, format: String,
@ -101,7 +111,7 @@ impl HTMLMediaElement {
Self { Self {
htmlelement: HTMLElement::new_inherited(tag_name, prefix, document), htmlelement: HTMLElement::new_inherited(tag_name, prefix, document),
network_state: Cell::new(NetworkState::Empty), network_state: Cell::new(NetworkState::Empty),
ready_state: Cell::new(HAVE_NOTHING), ready_state: Cell::new(ReadyState::HaveNothing),
current_src: DOMRefCell::new("".to_owned()), current_src: DOMRefCell::new("".to_owned()),
generation_id: Cell::new(0), generation_id: Cell::new(0),
fired_loadeddata_event: Cell::new(false), fired_loadeddata_event: Cell::new(false),
@ -184,7 +194,7 @@ impl HTMLMediaElement {
} }
// https://html.spec.whatwg.org/multipage/#ready-states // https://html.spec.whatwg.org/multipage/#ready-states
fn change_ready_state(&self, ready_state: u16) { fn change_ready_state(&self, ready_state: ReadyState) {
let old_ready_state = self.ready_state.get(); let old_ready_state = self.ready_state.get();
self.ready_state.set(ready_state); self.ready_state.set(ready_state);
@ -197,9 +207,9 @@ impl HTMLMediaElement {
// Step 1 // Step 1
match (old_ready_state, ready_state) { match (old_ready_state, ready_state) {
// previous ready state was HAVE_NOTHING, and the new ready state is // Previous ready state was ReadyState::HaveNothing,
// HAVE_METADATA // and the new ready state is ReadyState::HaveMetadata.
(HAVE_NOTHING, HAVE_METADATA) => { (ReadyState::HaveNothing, ReadyState::HaveMetadata) => {
task_source.queue_simple_event( task_source.queue_simple_event(
self.upcast(), self.upcast(),
atom!("loadedmetadata"), atom!("loadedmetadata"),
@ -207,11 +217,11 @@ impl HTMLMediaElement {
); );
} }
// previous ready state was HAVE_METADATA and the new ready state is // Previous ready state was ReadyState::HaveMetadata, and the new
// HAVE_CURRENT_DATA or greater // ready state is ReadyState::HaveCurrentData or greater.
(HAVE_METADATA, HAVE_CURRENT_DATA) | (ReadyState::HaveMetadata, ReadyState::HaveCurrentData) |
(HAVE_METADATA, HAVE_FUTURE_DATA) | (ReadyState::HaveMetadata, ReadyState::HaveFutureData) |
(HAVE_METADATA, HAVE_ENOUGH_DATA) => { (ReadyState::HaveMetadata, ReadyState::HaveEnoughData) => {
if !self.fired_loadeddata_event.get() { if !self.fired_loadeddata_event.get() {
self.fired_loadeddata_event.set(true); self.fired_loadeddata_event.set(true);
task_source.queue_simple_event( task_source.queue_simple_event(
@ -222,29 +232,29 @@ impl HTMLMediaElement {
} }
} }
// previous ready state was HAVE_FUTURE_DATA or more, and the new ready // previous ready state was ReadyState::HaveFutureData or more,
// state is HAVE_CURRENT_DATA or less // and the new ready state is ReadyState::HaveCurrentData or less.
(HAVE_FUTURE_DATA, HAVE_CURRENT_DATA) | (ReadyState::HaveFutureData, ReadyState::HaveCurrentData) |
(HAVE_ENOUGH_DATA, HAVE_CURRENT_DATA) | (ReadyState::HaveEnoughData, ReadyState::HaveCurrentData) |
(HAVE_FUTURE_DATA, HAVE_METADATA) | (ReadyState::HaveFutureData, ReadyState::HaveMetadata) |
(HAVE_ENOUGH_DATA, HAVE_METADATA) | (ReadyState::HaveEnoughData, ReadyState::HaveMetadata) |
(HAVE_FUTURE_DATA, HAVE_NOTHING) | (ReadyState::HaveFutureData, ReadyState::HaveNothing) |
(HAVE_ENOUGH_DATA, HAVE_NOTHING) => { (ReadyState::HaveEnoughData, ReadyState::HaveNothing) => {
// TODO: timeupdate event logic + waiting // TODO: timeupdate event logic + waiting
} }
_ => (), _ => (),
} }
// Step 1 // Step 1.
// If the new ready state is HAVE_FUTURE_DATA or HAVE_ENOUGH_DATA, // If the new ready state is ReadyState::HaveFutureData or ReadyState::HaveEnoughData,
// then the relevant steps below must then be run also. // then the relevant steps below must then be run also.
match (old_ready_state, ready_state) { match (old_ready_state, ready_state) {
// previous ready state was HAVE_CURRENT_DATA or less, and the new ready // Previous ready state was ReadyState::HaveCurrentData or less,
// state is HAVE_FUTURE_DATA // and the new ready state is ReadyState::HaveFutureData.
(HAVE_CURRENT_DATA, HAVE_FUTURE_DATA) | (ReadyState::HaveCurrentData, ReadyState::HaveFutureData) |
(HAVE_METADATA, HAVE_FUTURE_DATA) | (ReadyState::HaveMetadata, ReadyState::HaveFutureData) |
(HAVE_NOTHING, HAVE_FUTURE_DATA) => { (ReadyState::HaveNothing, ReadyState::HaveFutureData) => {
task_source.queue_simple_event( task_source.queue_simple_event(
self.upcast(), self.upcast(),
atom!("canplay"), atom!("canplay"),
@ -256,9 +266,9 @@ impl HTMLMediaElement {
} }
} }
// new ready state is HAVE_ENOUGH_DATA // New ready state is ReadyState::HaveEnoughData.
(_, HAVE_ENOUGH_DATA) => { (_, ReadyState::HaveEnoughData) => {
if old_ready_state <= HAVE_CURRENT_DATA { if old_ready_state <= ReadyState::HaveCurrentData {
task_source.queue_simple_event( task_source.queue_simple_event(
self.upcast(), self.upcast(),
atom!("canplay"), atom!("canplay"),
@ -518,8 +528,8 @@ impl HTMLMediaElement {
// TODO 4.4 (forget resource tracks) // TODO 4.4 (forget resource tracks)
// 4.5 // 4.5
if self.ready_state.get() != HAVE_NOTHING { if self.ready_state.get() != ReadyState::HaveNothing {
self.change_ready_state(HAVE_NOTHING); self.change_ready_state(ReadyState::HaveNothing);
} }
// 4.6 // 4.6
@ -552,7 +562,7 @@ impl HTMLMediaElementMethods for HTMLMediaElement {
// https://html.spec.whatwg.org/multipage/#dom-media-readystate // https://html.spec.whatwg.org/multipage/#dom-media-readystate
fn ReadyState(&self) -> u16 { fn ReadyState(&self) -> u16 {
self.ready_state.get() self.ready_state.get() as u16
} }
// https://html.spec.whatwg.org/multipage/#dom-media-autoplay // https://html.spec.whatwg.org/multipage/#dom-media-autoplay
@ -629,9 +639,9 @@ impl HTMLMediaElementMethods for HTMLMediaElement {
task_source.queue_simple_event(self.upcast(), atom!("play"), &window); task_source.queue_simple_event(self.upcast(), atom!("play"), &window);
// 7.4 // 7.4
if state == HAVE_NOTHING || if state == ReadyState::HaveNothing ||
state == HAVE_METADATA || state == ReadyState::HaveMetadata ||
state == HAVE_CURRENT_DATA { state == ReadyState::HaveCurrentData {
task_source.queue_simple_event( task_source.queue_simple_event(
self.upcast(), self.upcast(),
atom!("waiting"), atom!("waiting"),
@ -642,7 +652,7 @@ impl HTMLMediaElementMethods for HTMLMediaElement {
} }
} }
// Step 8 // Step 8
else if state == HAVE_FUTURE_DATA || state == HAVE_ENOUGH_DATA { else if state == ReadyState::HaveFutureData || state == ReadyState::HaveEnoughData {
// TODO resolve pending play promises // TODO resolve pending play promises
} }
@ -819,7 +829,7 @@ impl FetchResponseListener for HTMLMediaElementContext {
if !self.have_metadata { if !self.have_metadata {
self.check_metadata(&elem); self.check_metadata(&elem);
} else { } else {
elem.change_ready_state(HAVE_CURRENT_DATA); elem.change_ready_state(ReadyState::HaveCurrentData);
} }
// https://html.spec.whatwg.org/multipage/#concept-media-load-resource step 4, // https://html.spec.whatwg.org/multipage/#concept-media-load-resource step 4,
@ -846,7 +856,7 @@ impl FetchResponseListener for HTMLMediaElementContext {
} }
// => "Once the entire media resource has been fetched..." // => "Once the entire media resource has been fetched..."
else if status.is_ok() { else if status.is_ok() {
elem.change_ready_state(HAVE_ENOUGH_DATA); elem.change_ready_state(ReadyState::HaveEnoughData);
elem.upcast::<EventTarget>().fire_event(atom!("progress")); elem.upcast::<EventTarget>().fire_event(atom!("progress"));
@ -855,7 +865,7 @@ impl FetchResponseListener for HTMLMediaElementContext {
elem.upcast::<EventTarget>().fire_event(atom!("suspend")); elem.upcast::<EventTarget>().fire_event(atom!("suspend"));
} }
// => "If the connection is interrupted after some media data has been received..." // => "If the connection is interrupted after some media data has been received..."
else if elem.ready_state.get() != HAVE_NOTHING { else if elem.ready_state.get() != ReadyState::HaveNothing {
// Step 2 // Step 2
elem.error.set(Some(&*MediaError::new(&*window_from_node(&*elem), elem.error.set(Some(&*MediaError::new(&*window_from_node(&*elem),
MEDIA_ERR_NETWORK))); MEDIA_ERR_NETWORK)));
@ -912,7 +922,7 @@ impl HTMLMediaElementContext {
audio: meta.audio.audio, audio: meta.audio.audio,
}); });
// Step 6 // Step 6
elem.change_ready_state(HAVE_METADATA); elem.change_ready_state(ReadyState::HaveMetadata);
self.have_metadata = true; self.have_metadata = true;
} }
_ => {} _ => {}