1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

//! Wrapper for the [`chrome.tabs` API](https://developer.chrome.com/docs/extensions/reference/tabs/).

pub(crate) mod prelude {
    pub(crate) use crate::util::{js_from_serde, object_from_js, serde_from_js_result};
    pub use crate::{event_listener::EventListener, tabs::TabId, Error};
    pub use serde::{Deserialize, Serialize};
    pub use wasm_bindgen::closure::Closure;
    pub use web_extensions_sys as sys;

    pub fn tabs() -> sys::Tabs {
        // Currently we assume a chrome browser and Manifest V3.
        //
        // Once MV3 is supported by FireFox, we need to check if we can use the same namespace,
        // a shim or our own implementation.
        sys::chrome().tabs()
    }
}

use self::prelude::*;

/// The ID of the tab.
///
/// Tab IDs are unique within a browser session.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub struct TabId(i32);

impl From<i32> for TabId {
    fn from(id: i32) -> Self {
        Self(id)
    }
}

mod on_activated;
mod on_attached;
mod on_created;
mod on_detached;
mod on_highlighted;
mod on_moved;
mod on_removed;
mod on_replaced;
mod on_updated;
mod on_zoom_change;

mod muted_info;
mod query_details;
mod status;
mod tab;
mod window_type;

pub use self::{
    muted_info::*, on_activated::*, on_attached::*, on_created::*, on_detached::*,
    on_highlighted::*, on_moved::*, on_removed::*, on_replaced::*, on_updated::*,
    on_zoom_change::*, query_details::*, status::*, tab::*, window_type::*,
};

/// <https://developer.chrome.com/docs/extensions/reference/tabs/#method-get>
pub async fn get(tab_id: TabId) -> Result<Tab, Error> {
    let result = tabs().get(tab_id.0).await;
    serde_from_js_result(result)
}

/// <https://developer.chrome.com/docs/extensions/reference/tabs/#method-query>
pub async fn query(details: &QueryDetails<'_>) -> Result<Vec<Tab>, Error> {
    let js_details = js_from_serde(details)?;
    let result = tabs().query(object_from_js(&js_details)?).await;
    serde_from_js_result(result)
}

/// <https://developer.chrome.com/docs/extensions/reference/tabs/#method-sendMessage>
pub async fn send_message<T>(tab_id: TabId, message: &T) -> Result<(), Error>
where
    T: Serialize,
{
    let js_message = js_from_serde(message)?;
    let options = None;
    tabs()
        .send_message(tab_id.0, &js_message, options)
        .await
        .map(|_| ())?;
    Ok(())
}

/// <https://developer.chrome.com/docs/extensions/reference/tabs/#method-create>
pub async fn create(props: CreateProperties<'_>) -> Result<Tab, Error> {
    let js_props = js_from_serde(&props)?;
    let result = tabs().create(object_from_js(&js_props)?).await;
    serde_from_js_result(result)
}

/// Information necessary to open a new tab.
#[derive(Debug, Serialize, Deserialize)]
pub struct CreateProperties<'a> {
    pub active: bool,
    pub url: &'a str,
}