stdweb下載 - stdweb源代碼下載

stdweb

網站數據

1.0.0

下載

客戶端網絡的標準庫

該板條箱的目的是為Web API提供生鏽的綁定，並允許Rust和JavaScript之間具有高度的互操作性。

捐

顧客

由於這些出色的人，該軟件被帶給您：

Embark Studios
喬·納爾瓦茲（Joe Narvaez）
愛德華·克諾夫（Eduard Knyshov）
安塞爾姆·埃克霍夫（Anselm Eickhoff）
約翰·安德森（Johan Andersson）
斯蒂芬·蘇格登（Stephen Sugden）
IS8AC

謝謝你！

例子

您可以將JavaScript代碼直接嵌入Rust：

 let message = "Hello, 世界!" ;
let result = js ! {
    alert ( @ { message } ) ;
    return 2 + 2 * 2 ;
} ;

println ! ( "2 + 2 * 2 = {:?}" , result ) ;

還支持關閉：

 let print_hello = | name : String | {
    println ! ( "Hello, {}!" , name ) ;
} ;

js ! {
    var print_hello = @ { print_hello } ;
    print_hello ( "Bob" ) ;
    print_hello . drop ( ) ; // Necessary to clean up the closure on Rust's side.
}

您也可以通過Serde通過任意結構：

 # [ derive ( Serialize ) ]
struct Person {
    name : String ,
    age : i32
}

js_serializable ! ( Person ) ;

js ! {
    var person = @ { person } ;
    console . log ( person . name + " is " + person . age + " years old." ) ;
} ;

該板條箱還暴露了許多Web API，例如：

 let button = document ( ) . query_selector ( "#hide-button" ) . unwrap ( ) . unwrap ( ) ;
button . add_event_listener ( move |_ : ClickEvent | {
    for anchor in document ( ) . query_selector_all ( "#main a" ) {
        js ! ( @ { anchor } . style = "display: none;" ; ) ;
    }
} ) ;

也支持將Rust功能暴露於JavaScript：

 # [ js_export ]
fn hash ( string : String ) -> String {
    let mut hasher = Sha1 :: new ( ) ;
    hasher . update ( string . as_bytes ( ) ) ;
    hasher . digest ( ) . to_string ( )
}

然後，您可以從Node.js：

 var hasher = require ( "hasher.js" ) ; // Where `hasher.js` is generated from Rust code.
console . log ( hasher . hash ( "Hello world!" ) ) ;

或者，您可以使用相同的.js文件並在Web瀏覽器中使用它：

 < script src =" hasher.js " > </ script >
< script >
    Rust . hasher . then ( function ( hasher ) {
        console . log ( hasher . hash ( "Hello world!" ) ) ;
    } ) ;
</ script >

如果您使用的是包裹，也可以使用我們的實驗包裹插件；首先在您現有的包裹項目中執行此操作：

 $ npm install --save parcel-plugin-cargo-web

然後簡單：

 import hasher from "./hasher/Cargo.toml" ;
console . log ( hasher . hash ( "Hello world!" ) ) ;

設計目標

揭示由Web瀏覽器公開的完整的Web API套件。
嘗試盡可能遵循原始的JavaScript約定和結構，除非這樣做否則會導致明顯的設計。
成為一個可以從中建立更高級別框架和庫的組成部分。
使其方便且易於將JavaScript代碼直接嵌入RUST和兩者之間的元帥數據。
與更廣泛的銹生態系統集成，例如支持實現Serde序列化的結構的套裝。
將Rust放在駕駛員座椅上，在該駕駛員座位上可以編寫非平凡的Web應用程序，而無需觸摸JavaScript。
讓Rust參加即將到來的WebAssembly（RE）卷。
使得可以從JavaScript中易於調用的獨立庫瑣碎地創建獨立的庫。

入門

看看一些示例：

examples/minimal - 一個完全最小的示例，調用警報
examples/todomvc一種天真的todomvc應用程序；顯示如何致電DOM
examples/hasher顯示如何將Rust功能導出到JavaScript以及如何從Vanilla Web瀏覽器環境或Nodejs撥打它們
examples/hasher-parcel顯示如何在包裹項目中導入和調用出口的Rust功能
pinky-web NES仿真器；您可以在此處使用預編譯版本

API文檔也可以供您查看。

運行示例

安裝貨物 - 韋布：
```
 $ cargo install -f cargo-web
```
進入examples/todomvc ，並使用以下命令之一啟動示例：
- 使用Rust的本機WebAssembly後端編譯到WebAssmbly：
```
 $ cargo web start --target=wasm32-unknown-unknown
```
- 使用Emscripten編譯為ASM.JS：
```
 $ cargo web start --target=asmjs-unknown-emscripten
```
- 使用Emscripten編譯到WebAssembly：
```
 $ cargo web start --target=wasm32-unknown-emscripten
```
請訪問http://localhost:8000 with瀏覽器。

對於*-emscripten而言，無需cargo-web ，但是不需要emscripten的本地wasm32-unknown-unknown不需要貨物，需要cargo-web工作！

ChangElog

stdweb 0.4.20
- 與最新的wasm-bindgen兼容性
- 新事件：
  - FullscreenChangeEvent
stdweb 0.4.19
- 新方法：
  - Document::fullscreen_enabled
  - Document::fullscreen_element
  - InputElement::selection_start
  - InputElement::selection_end
  - InputElement::set_selection_start
  - InputElement::set_selection_end
  - Object::to_iter
  - Window::confirm
- &Array現在可以通過TryFrom轉換為Vec s
- 現在，運行時應與Emscripten的較新版本兼容
- 與futures相關的不穩定的API已更新以與最新的夜間合作
- syn依賴項已更新為版本1
stdweb 0.4.18
- js!現在可以在use中導入宏
- 新事件：
  - BeforeUnloadEvent
  - UnloadEvent
- 新方法：
  - IBlob::slice
  - IBlob::slice_with_content_type
  - IWindowOrWorker::set_clearable_timeout
stdweb 0.4.17
- 與futures相關的不穩定的API已更新以與最新的夜間合作
stdweb 0.4.16
- 初始wasm-bindgen兼容性；您現在可以使用wasm-bindgen在項目中使用stdweb
- 現在，最低支持的Rust版本為1.33.0
- 最低所需的cargo-web版本現在為0.6.24
stdweb 0.4.15
- 與futures相關的不穩定的API已更新以與最新的夜間合作
- 新類型：
  - FormData
  - FormDataEntry
  - MouseButtonsState
- 新方法：
  - Blob::new
stdweb 0.4.14
- js!如果您沒有從JS片段中返回任何內容，則宏現在會生成更有效的代碼。這使得在絕大多數情況下不必添加@(no_return)註釋。
- 新類型：
  - File
stdweb 0.4.13
- 修復了程序js!宏的空間處理
- 新類型：
  - ITouchEvent
  - Touch
  - TouchType
- 新事件：
  - TouchEvent
  - TouchMove
  - TouchLeave
  - TouchEnter
  - TouchEnd
  - TouchCancel
  - TouchStart
- 新方法：
  - XmlHttpRequest::set_response_type
stdweb 0.4.12
- 嘗試編譯wasm32-unknown-unknown目標而沒有cargo-web改進了診斷方法
stdweb 0.4.11
- 最低要求的銹版本現在為1.30.1
- 最低所需的cargo-web版本現在為0.6.22
- wasm32-unknown-unknown現已正式支持穩定的Rust
- 現在支持以wasm32-unknown-unknown為基礎的調試
- js!現在使用程序宏部分實現宏
- 由於使用本機編解碼器API，字符串解碼/編碼現在要快得多
- 新方法：
  - Document::import_node
  - IElement::slot
  - IElement::attach_shadow
  - IElement::shadow_root
- 新類型：
  - ISlotable
  - ShadowRoot
  - ShadowRootMode
  - TemplateElement
  - SlotElement
- 新事件：
  - SlotChangeEvent
- IParentNode::query_selector和IParentNode::query_selector_all現在返回正確的錯誤類型
stdweb 0.4.10 ， stdweb-derive 0.5.1
- 新方法：
  - IElement::insert_adjacent_html
  - IElement::insert_html_before
  - IElement::insert_html_after
  - IElement::prepend_html
  - IElement::append_html
  - IElement::namespace_uri
  - IElement::closest
  - Document::create_element_ns
  - Window::get_selection
- 新類型：
  - AbortError
  - SelectionType
  - Selection
  - Range
- 現在改善了失敗類型轉換的錯誤消息
- 轉換失敗的錯誤類型（使用.try_into() / .try_from() ）現在可轉換為TypeError
- 現在可以通過JS序列化的聚合錯誤類型（例如DrawImageError ） js!宏
- 現在固定了TypeError （被錯誤地視為DOMException ）
- 現在可以使用.into() / .from()將Number轉換為f64
- 添加了Mut ，這是一種新的包裝類型，可安全地將FnMut封閉插入js!宏；目前是可選的，但是這種包裝紙的使用將來將是強制性的！
- FnMut關閉不能再遞歸地稱為
- #[derive(ReferenceType)]現在支持一個有限的通用類型子集
- 現在使用新的#[async_test]屬性宏支持異步單元測試（僅每晚）
- 更新為futures 0.3 （僅每晚）
stdweb 0.4.9 ， stdweb-derive 0.5.0
- 績效提高；通過Serde序列化現在是兩倍的速度
- 新事件：
  - ScrollEvent
  - DragRelatedEvent
  - DragEvent
  - DragStartEvent
  - DragEndEvent
  - DragEnterEvent
  - DragLeaveEvent
  - DragOverEvent
  - DragExitEvent
  - DragDropEvent
- 新類型：
  - DataTransfer
  - EffectAllowed
  - DropEffect
  - DataTransferItemList
  - DataTransferItem
  - DataTransferItemKind
  - IDragEvent
- Value S現在可以轉換為try_into Option< Serde< T > >
- 現在，通過SERDE對數字進行驗證，現在在大多數情況下都可以使用i32和f64以外的其他類型
- 現在所有事件都更加強烈
  - 以前可以在keyup事件中進行KeyDownEvent化，因為僅檢查了事件的JS類型，並且keyup和keydown共享相同的JS類型（ KeyboardEvent ）。從現在開始，還檢查了事件的type字段，因此不再允許這樣的轉換。
0.4.8
- 固定了針對wasm32-unknown-unknown最新夜間彙編
- 新事件：
  - PointerLockChangeEvent
  - PointerLockErrorEvent
  - MouseWheelEvent
- 新類型：
  - MouseWheelDeltaMode
  - XhrResponseType
- 新方法：
  - XmlHttpRequest::raw_response
  - Window::device_pixel_ratio
  - Document::pointer_lock_element
  - Document::exit_pointer_lock
0.4.7
- 新事件：
  - AuxClickEvent
  - MouseEnterEvent
  - MouseLeaveEvent
  - ContextMenuEvent
  - SelectionChangeEvent
- 新類型：
  - FileList
  - FileReaderReadyState
- 實施GamePad API：
  - Gamepad
  - GamepadButton
  - GamepadButtonMapping
  - GamepadEvent
- 修復了CanvasRenderingContext2d::clear_rect
- 修復了從Vec S和ArrayBuffer s創建TypedArray時的洩漏。
0.4.6
- 再次修復docs.rs
- 新類型：
  - SubmitEvent
  - IChildNode
- 修復CanvasElement::to_data_url
0.4.5
- 新類型：
  - DocumentFragment
  - SelectElement
  - OptionElement
  - HtmlCollection
- 新方法：
  - Node::from_html
  - Value::is_null
- 暴露枚舉：
  - SocketMessageData
  - NodeType
- 更新futures 0.2
0.4.4
- 修復docs.rs （希望）。
- 新方法：
  - Location::origin
  - Location::protocol
  - Location::host
  - Location::hostname
  - Location::port
  - Location::pathname
  - Location::search
- 這些現在在錯誤情況下返回SecurityError ：
  - Location::hash
  - Location::href
0.4.3
- 現在應支持無法用作WeakMap中鍵的對象（例如，在Firefox下的一些與WebGL相關的對象）
- 新方法：
  - Element::get_bounding_client_rect
  - Element::scroll_top
  - Element::scroll_left
  - Window::page_x_offset
  - Window::page_y_offset
  - NodeList::item
  - Document::body
  - Document::head
  - Document::title
  - Document::set_title
  - IMouseEvent::offset_x
  - IMouseEvent::offset_y
- 暴露更多帆布相關類型：
  - CompositeOperation
  - LineCap
  - LineJoin
  - Repetition
  - TextAlign
  - TextBaseline
- 暴露帆布相關的錯誤類型： AddColorStopError ， DrawImageError ， GetImageDataError
- 新事件：
  - MouseOverEvent
  - MouseOutEvent
  - PointerOverEvent
  - PointerEnterEvent
  - PointerDownEvent
  - PointerMoveEvent
  - PointerUpEvent
  - PointerCancelEvent
  - PointerOutEvent
  - PointerLeaveEvent
  - GotPointerCaptureEvent
  - LostPointerCaptureEvent
- 指針事件的新接口： IPointerEvent
0.4.2
- 修復了應有的參考時洩漏
- 修復了CanvasRenderingContext2d::get_canvas
- 裸露的FillRule和SocketReadyState
- 添加到IElement新屬性與屬性相關的方法
- 新Date綁定
0.4.1
- 支持wasm32-unknown-unknown最新夜間生鏽
- 裸露的SocketBinaryType枚舉
- 新的帆布API：
  - CanvasRenderingContext2d的許多新方法
  - 新類型： CanvasGradient ， CanvasPattern ， CanvasStyle ， ImageData ， TextMetrics
- 新錯誤類型： IndexSizeError ， NotSupportedError ， TypeError
0.4
- （打破變化）從Value中刪除了Array和Object變體；這些現在被視為Reference
- （打破變化）該Value具有額外的變體： Symbol
- （打破變化）刪除：
  - InputElement::set_kind
  - InputElement::files
- （打破變化）重命名：
  - KeydownEvent > KeyDownEvent
  - KeyupEvent > KeyUpEvent
  - KeypressEvent > KeyPressEvent
  - ReadyState > FileReaderReadyState
  - InputElement::value > InputElement::raw_value
  - InputElement::set_value > InputElement::set_raw_value
- （打破變化） ArrayBuffer::new現在採用u64參數
- （打破變化） InputElement::set_raw_value現在使用&str而Into< Value >
- （打破變化）更改返回類型：
  - 現在返回usize的每種方法現在返回u32
  - INode::remove_child現在在Ok情況下返回Node
  - 現在以下返回u64 ：
    - ArrayBuffer::len
  - 現在以下返回i32而不是f64 ：
    - IMouseEvent::client_x
    - IMouseEvent::client_y
    - IMouseEvent::movement_x
    - IMouseEvent::movement_y
    - IMouseEvent::screen_x
    - IMouseEvent::screen_y
  - 現在以下返回Result ：
    - INode::insert_before
    - INode::replace_child
    - INode::clone_node
    - StringMap::insert
    - TokenList::add
    - TokenList::remove
    - Document::create_element
    - IEventTarget::dispatch_event
    - FileReader::read_as_text
    - FileReader::read_as_array_buffer
    - FileReader::read_as_text
    - History::replace_state
    - History::go
    - History::back
    - History::forward
    - Location::href
    - Location::hash
    - CanvasElement::to_data_url
    - CanvasElement::to_blob
    - ArrayBuffer::new
  - INode::base_uri現在返回String ，而不是Option< String >
  - InputElement::raw_value現在返回String而不是Value
- （打破變化） INode::inner_text移動到IHtmlElement::inner_text
- （打破更改） Document::query_selector和Document::query_selector_all移動到IParentNode
- IElement::query_selector IParentNode IElement::query_selector_all ）
- （打破更改） Document::get_element_by_id已移至INonElementParentNode
- （打破變化）已刪除了使用TryFrom / TryInto在任意參考的對象之間轉換的毯子式
- 當使用最近的cargo-web構建時，不必再調用stdweb::initialize stdweb::event_loop
- 在wasm32-unknown-unknown cdylib板條板上的支持
- 新綁定：
  - XmlHttpRequest
  - WebSocket
  - MutationObserver
  - History
  - TextAreaElement
  - CanvasElement
- 新事件類型：
  - MouseDownEvent
  - MouseUpEvent
  - MouseMoveEvent
  - PopStateEvent
  - ResizeEvent
  - ReadyStateChange
  - SocketCloseEvent
  - SocketErrorEvent
  - SocketOpenEvent
  - SocketMessageEvent
- 對畫布API的初步支持
- 新特徵： ReferenceType和InstanceOf
- 在stdweb-derive板條箱中添加#[derive(ReferenceType)] ；現在可以在stdweb之外定義自定義API綁定
- 添加#[js_export]程序屬性（僅wasm32-unknown-unknown ）
- 添加DomException和子類型，以使JavaScript異常傳遞
- IElement現在從INode繼承
- 現在每個界面從ReferenceType繼承
- 添加stdweb::traits模塊充當use前奏 - 我們所有的界面特徵
- 添加console!宏
- 現在，大多數類型現在實現PartialEq和Eq
0.3
- （打破變化）刪除ErrorEvent方法
- （打破變化）重命名：
  - LoadEvent > ResourceLoadEvent
  - AbortEvent > ResourceAbortEvent
  - ErrorEvent > ResourceErrorEvent
- 添加零成本切片傳遞給JS的UnsafeTypedArray js!
- 添加Once以將FnOnce關閉到js!