用於藍牙 Pub-Sub 的高級跨平台 API
Bluetooth
(擴展EventEmitter
)建立藍牙服務的實例。
constructor(serviceId)
constructor 是設定為true
範例屬性 使用鍵值對建立新服務
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
服務ID | 細繩 | 錯誤的 | 給定預設值來確定類型 |
start()
啟動藍牙服務。
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | Promise<ipc.Result> |
subscribe(id )
開始掃描與已知 UUID 相對應的已發佈值。一旦訂閱了 UUID,就會發出與該 UUID 對應的事件。若要接收這些事件,您可以新增事件偵聽器,例如...
const ble = new Bluetooth ( id )
ble . subscribe ( uuid )
ble . on ( uuid , ( data , details ) => {
// ...do something interesting
} )
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
ID | 細繩 | 錯誤的 | 眾所周知的 UUID |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | Promise<ipc.Result> |
publish(id, value)
開始為知名 UUID 宣傳新價值
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
ID | 細繩 | 錯誤的 | 眾所周知的 UUID | |
價值 | 細繩 | 錯誤的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
外部文件:https://nodejs.org/api/buffer.html#buffer_class_buffer
來自 Node.js 的緩衝模組,用於瀏覽器。
If Buffer.TYPED_ARRAY_SUPPORT
: === true 使用 Uint8Array 實作(最快) === false 列印警告並建議使用具有 Object 實現的buffer
v4.x(最相容,甚至 IE6)
支援類型化陣列的瀏覽器有 IE 10+、Firefox 4+、Chrome 7+、Safari 5.1+、Opera 11.6+、iOS 4.2+。
我們報告說,如果類型化數組不能使用proto進行子類化,則瀏覽器不支援它們。 Firefox 4-29 不支援為Uint8Array
新增屬性(請參閱:https://bugzilla.mozilla.org/show_bug.cgi?id=695438)。 IE 10 缺乏對proto的支持,並且有一個有缺陷的類型數組實現。
If Buffer.TYPED_ARRAY_SUPPORT
: === true 使用 Uint8Array 實作(最快) === false 列印警告並建議使用具有 Object 實現的buffer
v4.x(最相容,甚至 IE6)
支援類型化陣列的瀏覽器有 IE 10+、Firefox 4+、Chrome 7+、Safari 5.1+、Opera 11.6+、iOS 4.2+。
我們報告說,如果類型化數組不能使用proto進行子類化,則瀏覽器不支援它們。 Firefox 4-29 不支援為Uint8Array
新增屬性(請參閱:https://bugzilla.mozilla.org/show_bug.cgi?id=695438)。 IE 10 缺乏對proto的支持,並且有一個有缺陷的類型數組實現。
If Buffer.TYPED_ARRAY_SUPPORT
: === true 使用 Uint8Array 實作(最快) === false 列印警告並建議使用具有 Object 實現的buffer
v4.x(最相容,甚至 IE6)
支援類型化陣列的瀏覽器有 IE 10+、Firefox 4+、Chrome 7+、Safari 5.1+、Opera 11.6+、iOS 4.2+。
我們報告說,如果類型化數組不能使用proto進行子類化,則瀏覽器不支援它們。 Firefox 4-29 不支援為Uint8Array
新增屬性(請參閱:https://bugzilla.mozilla.org/show_bug.cgi?id=695438)。 IE 10 缺乏對proto的支持,並且有一個有缺陷的類型數組實現。
If Buffer.TYPED_ARRAY_SUPPORT
: === true 使用 Uint8Array 實作(最快) === false 列印警告並建議使用具有 Object 實現的buffer
v4.x(最相容,甚至 IE6)
支援類型化陣列的瀏覽器有 IE 10+、Firefox 4+、Chrome 7+、Safari 5.1+、Opera 11.6+、iOS 4.2+。
我們報告說,如果類型化數組不能使用proto進行子類化,則瀏覽器不支援它們。 Firefox 4-29 不支援為Uint8Array
新增屬性(請參閱:https://bugzilla.mozilla.org/show_bug.cgi?id=695438)。 IE 10 缺乏對proto的支持,並且有一個有缺陷的類型數組實現。
Buffer 建構子傳回Uint8Array
的實例,其原型改為Buffer.prototype
。此外, Buffer
是Uint8Array
的子類,因此傳回的實例將具有所有節點Buffer
方法和Uint8Array
方法。方括號表示法按預期工作-它傳回單個八位元位元組。
Uint8Array
原型保持不變。
功能上相當於 Buffer(arg,encoding),但如果 value 是數字,則會拋出 TypeError。 Buffer.from(str[, 編碼]) Buffer.from(array) Buffer.from(buffer) Buffer.from(arrayBuffer[, byteOffset[, length]])
功能上相當於 Buffer(arg,encoding),但如果 value 是數字,則會拋出 TypeError。 Buffer.from(str[, 編碼]) Buffer.from(array) Buffer.from(buffer) Buffer.from(arrayBuffer[, byteOffset[, length]])
功能上相當於 Buffer(arg,encoding),但如果 value 是數字,則會拋出 TypeError。 Buffer.from(str[, 編碼]) Buffer.from(array) Buffer.from(buffer) Buffer.from(arrayBuffer[, byteOffset[, length]])
功能上相當於 Buffer(arg,encoding),但如果 value 是數字,則會拋出 TypeError。 Buffer.from(str[, 編碼]) Buffer.from(array) Buffer.from(buffer) Buffer.from(arrayBuffer[, byteOffset[, length]])
建立一個新的填充 Buffer 實例。分配(大小[,填充[,編碼]])
建立一個新的填充 Buffer 實例。分配(大小[,填充[,編碼]])
建立一個新的填充 Buffer 實例。分配(大小[,填充[,編碼]])
建立一個新的填充 Buffer 實例。分配(大小[,填充[,編碼]])
相當於 Buffer(num),預設建立一個非零填充的 Buffer 實例。
相當於 Buffer(num),預設建立一個非零填充的 Buffer 實例。
相當於 Buffer(num),預設建立一個非零填充的 Buffer 實例。
相當於 Buffer(num),預設建立一個非零填充的 Buffer 實例。
相當於 SlowBuffer(num),預設建立一個非零填充的 Buffer 實例。
相當於 SlowBuffer(num),預設建立一個非零填充的 Buffer 實例。
相當於 SlowBuffer(num),預設建立一個非零填充的 Buffer 實例。
相當於 SlowBuffer(num),預設建立一個非零填充的 Buffer 實例。
一些圍繞crypto.subtle
api 的高級方法,用於獲取隨機位元組和散列。
Web加密API
getRandomValues(buffer)
外部文件:https://developer.mozilla.org/en-US/docs/Web/API/Crypto/getRandomValues
將加密的強隨機值產生到buffer
中
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
緩衝 | 類型數組 | 錯誤的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 類型數組 |
每頁隨機位元組的最大總大小
隨機位元組的最大總大小。
每頁分配的最大位元組總數(最大/配額)
randomBytes(size)
產生size
隨機位元組。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
尺寸 | 數位 | 錯誤的 | 要產生的位元組數。大小不得大於 2**31 - 1。 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 緩衝 | 一個使用隨機位元組的 socket.Buffer 實例解析的承諾。 |
createDigest(algorithm, message)
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
演算法 | 細繩 | 錯誤的 | SHA-1 | |
訊息 | 緩衝器|類型化數組 |資料視圖 | 錯誤的 | socket.Buffer、TypedArray 或 Dataview 的實例。 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 | 一個使用帶有雜湊值的 socket.Buffer 實例進行解析的承諾。 |
此模組提供了 UDP 資料報套接字的實作。它(尚未)提供任何多播方法或屬性。
ERR_SOCKET_ALREADY_BOUND
(擴展SocketError
)當套接字已綁定時拋出。
ERR_SOCKET_DGRAM_IS_CONNECTED
(擴展SocketError
)當套接字已連接時拋出。
ERR_SOCKET_DGRAM_NOT_CONNECTED
(擴展SocketError
)當套接字未連接時拋出。
ERR_SOCKET_DGRAM_NOT_RUNNING
(擴展SocketError
)當套接字未運作(未綁定或連接)時拋出。
ERR_SOCKET_BAD_TYPE
(擴展TypeError
)當參數中使用錯誤的套接字類型時拋出。
ERR_SOCKET_BAD_PORT
(擴展RangeError
)當給出錯誤連接埠時拋出。
createSocket(options, callback)
建立一個Socket
實例。如果 ()
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選項 | 字串|目的 | 錯誤的 | 字串('udp4' 或 'udp6')或選項對象 | |
選項.類型 | 細繩 | 真的 | 套接字家族。必須是“udp4”或“udp6”。必需的。 | |
選項.reuseAddr | 布林值 | 錯誤的 | 真的 | 當 true 時,socket.bind() 將重複使用該位址,即使另一個進程已經在其上綁定了套接字。預設值:假。 |
選項.ipv6Only | 布林值 | 錯誤的 | 真的 | 將 ipv6Only 設為 true 將禁用雙棧支持,即綁定到地址 :: 不會綁定 0.0.0.0。預設值:假。 |
選項.recvBufferSize | 數位 | 真的 | 設定 SO_RCVBUF 套接字值。 | |
選項.sendBufferSize | 數位 | 真的 | 設定 SO_SNDBUF 套接字值。 | |
選項.訊號 | 中止訊號 | 真的 | 可用於關閉套接字的 AbortSignal。 | |
打回來 | 功能 | 真的 | 作為「訊息」事件的偵聽器附加。選修的。 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 插座 |
Socket
(擴展EventEmitter
)dgram.Socket 的新實例是使用 dgram.createSocket() 建立的。 new 關鍵字不用於建立 dgram.Socket 實例。
bind(port, address, callback)
外部文件:https://nodejs.org/api/dgram.html#socketbindport-address-callback
在指定連接埠和選用位址上偵聽資料封包訊息 如果未指定位址,作業系統將嘗試偵聽所有位址。綁定完成後,將發出“監聽”事件並呼叫可選的回調函數。
如果綁定失敗,則會發出「錯誤」事件。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
港口 | 數位 | 錯誤的 | 監聽訊息的連接埠 | |
地址 | 細繩 | 錯誤的 | 要綁定的位址 (0.0.0.0) | |
打回來 | 功能 | 錯誤的 | 沒有參數。綁定完成時呼叫。 |
connect(port, host, connectListener)
外部文件:https://nodejs.org/api/dgram.html#socketconnectport-address-callback
將 dgram.Socket 關聯到遠端位址和連接埠。此句柄發送的每個訊息都會自動傳送到該目的地。此外,套接字將僅接收來自該遠端對等點的訊息。嘗試在已連接的套接字上呼叫 connect() 將導致 ERR_SOCKET_DGRAM_IS_CONNECTED 異常。如果未提供位址,則預設使用「127.0.0.1」(對於 udp4 套接字)或「::1」(對於 udp6 套接字)。連接完成後,將發出“connect”事件並呼叫可選的回調函數。如果失敗,則會呼叫回調,或者如果失敗,則會發出「錯誤」事件。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
港口 | 數位 | 錯誤的 | 客戶端應連接到的連接埠。 | |
主持人 | 細繩 | 真的 | 客戶端應連接的主機。 | |
連接監聽器 | 功能 | 真的 | socket.connect() 方法的公共參數。將會被加入為「連線」事件的偵聽器一次。 |
disconnect()
外部文件:https://nodejs.org/api/dgram.html#socketdisconnect
一個同步函數,用於將連接的 dgram.Socket 與其遠端位址解除關聯。嘗試在未綁定或已斷開連接的套接字上呼叫disconnect()將導致ERR_SOCKET_DGRAM_NOT_CONNECTED異常。
send(msg, offset, length, port, address, callback)
外部文件:https://nodejs.org/api/dgram.html#socketsendmsg-offset-length-port-address-callback
在套接字上廣播資料報。對於無連接套接字,必須指定目標連接埠和位址。另一方面,連接的套接字將使用其關聯的遠端端點,因此不得設定連接埠和位址參數。
msg 參數包含要傳送的訊息。根據其類型,可以應用不同的行為。如果 msg 是 Buffer、任何 TypedArray 或 DataView,則偏移量和長度分別指定訊息開始的 Buffer 內的偏移量和訊息中的位元組數。如果 msg 是一個 String,那麼它會自動轉換為 'utf8' 編碼的 Buffer。對於包含多位元組字元的訊息,偏移量和長度將根據位元組長度而不是字元位置來計算。如果 msg 是數組,則不得指定偏移量和長度。
地址參數是一個字串。如果address的值為主機名,則將使用DNS來解析主機的位址。如果未提供位址或位址為空,則預設使用「127.0.0.1」(對於 udp4 套接字)或「::1」(對於 udp6 套接字)。
如果之前未透過呼叫綁定來綁定套接字,則會為套接字分配一個隨機連接埠號,並綁定到“所有介面”位址(對於udp4 套接字為“0.0.0.0”,對於udp6套接字為“::0” .)
可以指定一個可選的回呼函數作為報告 DNS 錯誤或決定何時可以安全地重複使用 buf 物件的方法。 DNS 查找會延遲 Node.js 事件循環至少一個週期的傳送時間。
確定資料報已發送的唯一方法是使用回調。如果發生錯誤並給出回調,則錯誤將作為第一個參數傳遞給回調。如果未給予回調,則錯誤將作為套接字物件上的「錯誤」事件發出。
偏移量和長度是可選的,但如果使用其中任何一個,則必須設定兩者。只有當第一個參數是 Buffer、TypedArray 或 DataView 時才支援它們。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
味精 | 緩衝器|類型化數組 |資料視圖 |字串|大批 | 錯誤的 | 待發送的訊息。 | |
抵銷 | 整數 | 真的 | 訊息開始的緩衝區中的偏移量。 | |
長度 | 整數 | 真的 | 訊息中的位元組數。 | |
港口 | 整數 | 真的 | 目的港。 | |
地址 | 細繩 | 真的 | 目標主機名稱或 IP 位址。 | |
打回來 | 功能 | 真的 | 訊息發送後調用。 |
close(callback)
外部文件:https://nodejs.org/api/dgram.html#socketclosecallback
關閉底層套接字並停止偵聽其上的資料。如果提供了回調,則會將其新增為「關閉」事件的偵聽器。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
打回來 | 功能 | 真的 | 連接完成或出錯時調用。 |
address()
外部文件:https://nodejs.org/api/dgram.html#socketaddress
傳回一個包含套接字位址資訊的物件。對於 UDP 套接字,該物件將包含位址、系列和連接埠屬性。
如果在未綁定的套接字上呼叫此方法,則會拋出 EBADF。
傳回值 | 類型 | 描述 |
---|---|---|
套接字訊息 | 目的 | 有關本地套接字的信息 |
套接字資訊位址 | 細繩 | 套接字的IP位址 |
套接字資訊端口 | 細繩 | 套接字的端口 |
socketInfo.family | 細繩 | 套接字的IP系列 |
remoteAddress()
外部文件:https://nodejs.org/api/dgram.html#socketremoteaddress
傳回一個包含遠端端點的位址、系列和連接埠的物件。如果套接字未連接,此方法將引發 ERR_SOCKET_DGRAM_NOT_CONNECTED 異常。
傳回值 | 類型 | 描述 |
---|---|---|
套接字訊息 | 目的 | 有關遠端套接字的信息 |
套接字資訊位址 | 細繩 | 套接字的IP位址 |
套接字資訊端口 | 細繩 | 套接字的端口 |
socketInfo.family | 細繩 | 套接字的IP系列 |
setRecvBufferSize(size)
外部文件:https://nodejs.org/api/dgram.html#socketsetrecvbuffersizesize
設定 SO_RCVBUF 套接字選項。設定最大套接字接收緩衝區(以位元組為單位)。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
尺寸 | 數位 | 錯誤的 | 新接收緩衝區的大小 |
setSendBufferSize(size)
外部文件:https://nodejs.org/api/dgram.html#socketsetsendbuffersizesize
設定 SO_SNDBUF 套接字選項。設定最大套接字發送緩衝區(以位元組為單位)。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
尺寸 | 數位 | 錯誤的 | 新發送緩衝區的大小 |
getRecvBufferSize()
外部文件:https://nodejs.org/api/dgram.html#socketgetrecvbuffersize
getSendBufferSize()
外部文件:https://nodejs.org/api/dgram.html#socketgetsendbuffersize
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 數位 | SO_SNDBUF 套接字會傳送緩衝區大小(以位元組為單位)。 |
此模組支援名稱解析。例如,用它來尋找主機名稱的 IP 位址。儘管以網域名稱系統 (DNS) 命名,但它並不總是使用 DNS 協定進行查找。 dns.lookup() 使用作業系統工具來執行名稱解析。它可能不需要執行任何網路通訊。若要像同一系統上的其他應用程式一樣執行名稱解析,請使用 dns.lookup()。
lookup(hostname, opts, cb)
外部文件:https://nodejs.org/api/dns.html#dns_dns_lookup_hostname_options_callback
將主機名稱(例如example.org
)解析為第一個找到的 A (IPv4) 或 AAAA (IPv6) 記錄。所有選項屬性都是可選的。如果 options 是整數,則它必須是 4 或 6 – 如果 options 是 0 或未提供,則如果找到,則傳回 IPv4 和 IPv6 位址。
從 Node.js 網站...
當 all 選項設為 true 時,回呼的參數將變更為 (err, 位址),其中位址是具有屬性 address 和 family 的物件陣列。
發生錯誤時, err 是 Error 對象,其中 err.code 是錯誤代碼。請記住,不僅當主機名稱不存在時,而且當查找因其他原因(例如沒有可用的檔案描述符)失敗時,err.code 都會被設定為「ENOTFOUND」。 dns.lookup() 不一定與 DNS 協定有任何關係。此實作使用可以將名稱與位址關聯起來的作業系統工具,反之亦然。這種實作可能會對任何 Node.js 程式的行為產生微妙但重要的影響。在使用 dns.lookup() 之前,請花一些時間查閱實作注意事項部分。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
主機名稱 | 細繩 | 錯誤的 | 要解析的主機名稱。 | |
選擇 | 目的 | 真的 | 一個選項物件。 | |
選擇家庭 | 數量 |細繩 | 0 | 錯誤的 | 唱片家族。必須為 4、6 或 0。值0表示同時回傳IPv4和IPv6位址。預設值:0。 |
CB | 功能 | 錯誤的 | 方法完成後呼叫的函數。 |
此模組支援名稱解析。例如,用它來尋找主機名稱的 IP 位址。儘管以網域名稱系統 (DNS) 命名,但它並不總是使用 DNS 協定進行查找。 dns.lookup() 使用作業系統工具來執行名稱解析。它可能不需要執行任何網路通訊。若要像同一系統上的其他應用程式一樣執行名稱解析,請使用 dns.lookup()。
lookup(hostname, opts)
外部文件:https://nodejs.org/api/dns.html#dnspromiseslookuphostname-options
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
主機名稱 | 細繩 | 錯誤的 | 要解析的主機名稱。 | |
選擇 | 目的 | 真的 | 一個選項物件。 | |
選擇家庭 | 數量 |細繩 | 0 | 錯誤的 | 唱片家族。必須為 4、6 或 0。值0表示同時回傳IPv4和IPv6位址。預設值:0。 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
此模組支援以標準 POSIX 函數建模的方式與檔案系統進行互動。
應用程式沙箱限制對檔案系統的存取。請參閱應用程式沙箱文件以獲取更多資訊:https://sockets.sh/guides/#working-with-the-file-system-on-ios
要使用基於 Promise 的 API:
import * as fs from '@socketsupply/socket-api/fs/promises.js' ;
要使用回呼和非同步 API:
import * as fs from '@socketsupply/socket-api/fs/index.js' ;
access(path, mode , callback)
外部文件:https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fsopenpath-flags-mode-callback
非同步檢查對給定模式的檔案訪問,在成功或錯誤時呼叫callback
。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
模式 | 細繩 | F_OK(0) | 真的 | |
打回來 | 函數(錯誤,fd) | 錯誤的 |
chmod(path, mode, callback)
外部文件:https://nodejs.org/api/fs.html#fschmodpath-mode-callback
異步更改文件的權限。除了可能的異常之外,不會向完成回調提供任何參數
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
模式 | 數位 | 錯誤的 | ||
打回來 | 函數(錯誤) | 錯誤的 |
close(fd, callback)
非同步關閉檔案描述符,在成功或錯誤時呼叫callback
。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
FD | 數位 | 錯誤的 | ||
打回來 | 函數(錯誤) | 真的 |
copyFile()
這是fs/index.js
中名為copyFile
FunctionDeclaration
,它已匯出但未記錄。
createReadStream(path, options)
外部文件:https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fscreatewritestreampath-options
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
選項 | 目的 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | fs.ReadStream |
createWriteStream(path, options)
外部文件:https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fscreatewritestreampath-options
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
選項 | 目的 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | fs.WriteStream |
fstat(fd, options, callback)
外部文件:https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fsfstatfd-options-callback
使用檔案描述符的 <fs.Stats> 呼叫回呼。有關更多詳細信息,請參閱 POSIX fstat(2) 文件。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
FD | 數位 | 錯誤的 | 文件描述符。 | |
選項 | 目的 | 真的 | 一個選項物件。 | |
打回來 | 功能 | 錯誤的 | 完成後呼叫的函數。 |
open(path, flags , mode , callback)
非同步開啟文件,在成功或錯誤時呼叫callback
。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
旗幟 | 細繩 | r | 真的 | |
模式 | 細繩 | 0o666 | 真的 | |
打回來 | 函數(錯誤,fd) | 錯誤的 |
opendir(path, options, callback)
非同步開啟一個目錄,在成功或錯誤時呼叫callback
。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.encoding | 細繩 | UTF8 | 真的 | |
選項.withFileTypes | 布林值 | 錯誤的 | 真的 | |
打回來 | 函數(錯誤,fd) | 錯誤的 |
read(fd, buffer, offset, length, position, callback)
從開啟的檔案描述符非同步讀取。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
FD | 數位 | 錯誤的 | ||
緩衝 | 對象|緩衝器|類型數組 | 錯誤的 | 資料將寫入的緩衝區。 | |
抵銷 | 數位 | 錯誤的 | 緩衝區中要寫入資料的位置。 | |
長度 | 數位 | 錯誤的 | 要讀取的位元組數。 | |
位置 | 數量 |大整數 |無效的 | 錯誤的 | 指定從文件中的何處開始讀取。如果position為null或-1,將從目前檔案位置讀取數據,並更新檔案位置。如果position是整數,則檔案位置將保持不變。 | |
打回來 | 函數(錯誤,位元組讀取,緩衝區) | 錯誤的 |
readdir(path, options, callback)
非同步讀取目錄中的所有條目。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.encoding | 細繩 | UTF8 | 真的 | |
選項.withFileTypes | 布林值 | 錯誤的 | 真的 | |
打回來 | 函數(錯誤,緩衝區) | 錯誤的 |
readFile(path, options, callback)
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 |數位 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.encoding | 細繩 | UTF8 | 真的 | |
選項標誌 | 細繩 | r | 真的 | |
選項.訊號 | 中止訊號 | 真的 | ||
打回來 | 函數(錯誤,緩衝區) | 錯誤的 |
stat(path, options, callback)
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 |數位 | 錯誤的 | 檔案名稱或檔案描述符 | |
選項 | 目的 | 真的 | ||
選項.encoding | 細繩 | UTF8 | 真的 | |
選項標誌 | 細繩 | r | 真的 | |
選項.訊號 | 中止訊號 | 真的 | ||
打回來 | 函數(錯誤,數據) | 錯誤的 |
writeFile(path, data, options, callback)
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 |數位 | 錯誤的 | 檔案名稱或檔案描述符 | |
數據 | 字串|緩衝器|類型化數組 |資料視圖 |目的 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.encoding | 細繩 | UTF8 | 真的 | |
選項.模式 | 細繩 | 0o666 | 真的 | |
選項標誌 | 細繩 | w | 真的 | |
選項.訊號 | 中止訊號 | 真的 | ||
打回來 | 函數(錯誤) | 錯誤的 |
writev()
這是fs/index.js
中名為writev
FunctionDeclaration
,它已匯出但未記錄。
access(path, mode, options)
外部文件:https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fspromisesaccesspath-mode
非同步檢查文件存取。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
模式 | 細繩 | 真的 | ||
選項 | 目的 | 真的 |
chmod(path, mode)
外部文件:https://nodejs.org/api/fs.html#fspromiseschmodpath-mode
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
模式 | 數位 | 錯誤的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
mkdir(path, options)
異步建立目錄。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 細繩 | 錯誤的 | 創建路徑 | |
選項 | 目的 | 錯誤的 | 可選的選項參數可以是指定模式(權限和黏性位元)的整數,也可以是具有模式屬性和指示是否應建立父目錄的遞歸屬性的物件。只有當 recursive 為 false 時,當 path 是存在的目錄時呼叫 fs.mkdir() 才會導致錯誤。 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 普里米斯 | 成功後,如果 recursive 為 false,則傳回 undefined;如果 recursive 為 true,則傳回建立的第一個目錄路徑。 |
open(path, flags, mode)
外部文件:https://nodejs.org/api/fs.html#fspromisesopenpath-flags-mode
異步打開文件。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
旗幟 | 細繩 | 錯誤的 | 預設值:“r” | |
模式 | 細繩 | 錯誤的 | 預設值:0o666 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
opendir(path, options)
外部文件:https://nodejs.org/api/fs.html#fspromisesopendirpath-options
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.encoding | 細繩 | UTF8 | 真的 | |
選項.bufferSize | 數位 | 32 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | Promise<檔案系統,目錄> |
readdir(path, options)
外部文件:https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fspromisesreaddirpath-options
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.encoding | 細繩 | UTF8 | 真的 | |
選項.withFileTypes | 布林值 | 錯誤的 | 真的 |
readFile(path, options)
外部文件:https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fspromisesreadfilepath-options
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 細繩 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.encoding | 字串|無效的 | 無效的 | 真的 | |
選項標誌 | 細繩 | r | 真的 | |
選項.訊號 | 中止訊號 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾<緩衝區 | 字串> |
stat(path, options)
外部文件:https://nodejs.org/api/fs.html#fspromisesstatpath-options
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.bigint | 布林值 | 錯誤的 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
writeFile(path, data, options)
外部文件:https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fspromiseswritefilefile-data-options
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
小路 | 字串|緩衝器|網址 |文件句柄 | 錯誤的 | 檔案名稱或檔案句柄 | |
數據 | 字串|緩衝器|數組 |資料視圖 |類型化數組 |溪流 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.encoding | 字串|無效的 | UTF8 | 錯誤的 | |
選項.模式 | 數位 | 0o666 | 錯誤的 | |
選項標誌 | 細繩 | w | 錯誤的 | |
選項.訊號 | 中止訊號 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
這是fs/stream.js
中名為DEFAULT_STREAM_HIGH_WATER_MARK
的VariableDeclaration
,它已匯出但未記錄。
ReadStream
(擴充Readable
) FileHandle
的Readable
流。
constructor()
ReadStream
類別建構函數
setHandle(handle)
設定 ReadStream 的檔案句柄。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
處理 | 文件句柄 | 錯誤的 |
highWaterMark()
ReadStream 的最大緩衝區大小。
path()
底層FileHandle
的相對或絕對路徑。
pending()
如果流處於掛起狀態, true
。
emit()
處理建構函式中options.emitClose
的shouldEmitClose
設定。
WriteStream
(擴充Writable
) FileHandle
的Writable
流。
constructor()
WriteStream
類別建構函數
setHandle(handle)
設定 WriteStream 的檔案句柄。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
處理 | 文件句柄 | 錯誤的 |
highWaterMark()
Writetream 的最大緩衝區大小。
path()
底層FileHandle
的相對或絕對路徑。
pending()
如果流處於掛起狀態, true
。
emit()
處理建構函式中options.emitClose
的shouldEmitClose
設定。
這是fs/stream.js
中名為FileReadStream
VariableDeclaration
,它已匯出但未記錄。
這是fs/stream.js
中名為FileWriteStream
VariableDeclaration
,它已匯出但未記錄。
這是一個低階 API,除非您在 Socket SDK 之上實作一個函式庫,否則您不需要它。 Socket SDK 應用程式有兩個或三個進程。
Render
進程,即執行 HTML、CSS 和 JS 的 UI。Bridge
進程,管理一切的薄層程式碼。Main
進程,適用於需要執行較繁重計算作業的應用程式。與電子不同的是,它是可選的。Bridge 進程管理 Render 和 Main 進程,它還可以在它們之間代理資料。
綁定過程使用標準輸入和輸出作為通訊方式。寫入管道寫入端的資料由作業系統緩衝,直到從管道讀取端讀取。
IPC 協定使用簡單的類似 URI 的方案。數據作為 ArrayBuffer 傳遞。
ipc://command?key1=value1&key2=value2...
postMessage()
這是ipc.js
中名為postMessage
的FunctionDeclaration
,它已匯出但未記錄。
表示 IPC 狀態正常。
表示 ERROR IPC 狀態。
IPC 請求的逾時(以毫秒為單位)。
ipc.debug.enabled
屬性的符號
parseSeq(seq, options)
將seq
解析為整數值
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
序列 | 字串|數位 | 錯誤的 | ||
選項 | 目的 | 真的 | ||
選項.bigint | 布林值 | 錯誤的 | 錯誤的 |
debug(enable)
如果debug.enabled === true
,則偵錯輸出將列印到控制台。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
使能夠 | 布林值 | 錯誤的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 布林值 |
Message
(擴展URL
)基於ipc://
URI 方案的 IPC 訊息容器。
PROTOCOL()
IPC 訊息的預期協定。
from(input, params)
從各種輸入建立一個Message
實例。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
輸入 | 字串|網址 |留言 |緩衝器|目的 | 錯誤的 | ||
參數 | 對象|字串| URL搜尋參數 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 訊息 |
isValidInput(input)
用於確定input
對於建構新Message
實例是否有效的謂詞。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
輸入 | 字串|網址 |留言 |緩衝器|目的 | 錯誤的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 布林值 |
constructor(input)
Message
類別建構函數。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
輸入 | 字串|網址 | 錯誤的 |
command()
計算出的 IPC 訊息名稱。
name()
計算出的 IPC 訊息名稱。
id()
計算出的命令的id
值。
seq()
計算指令的seq
(序列)值。
value()
訊息參數中可能給出的計算訊息值。該值會自動解碼,但不會被視為 JSON。
index()
計算出的命令index
值可能會引用命令作用域或源自的視窗索引。如果訊息參數中未指定,則該值預設為-1
。
json()
計算值解析為 JSON。如果該值不存在或無效的 JSON,則該值為null
。
params()
訊息參數的計算唯讀物件。
entries()
傳回計算參數作為條目
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 數組<數組<字串,混合>> |
set(key, value)
透過key
設定參數value
。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
鑰匙 | 細繩 | 錯誤的 | ||
價值 | 混合的 | 錯誤的 |
get(key, defaultValue)
透過key
獲取參數值。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
鑰匙 | 細繩 | 錯誤的 | ||
預設值 | 混合的 | 錯誤的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 混合的 |
delete(key)
key
刪除參數。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
鑰匙 | 細繩 | 錯誤的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 布林值 |
keys()
計算出的參數鍵。
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 大批 |
values()
計算的參數值。
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 大批 |
has(key)
用於確定參數中是否存在參數key
謂詞。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
鑰匙 | 細繩 | 錯誤的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 布林值 |
toJSON()
將Message
實例轉換為純 JSON 物件。
內部使用的結果類型,用於處理來自本機層的 IPC 結果值,其形式為{ err?, data? }
。此類物件的data
和err
屬性採用元組形式,可透過[data?,err?]
存取
from(result, maybeError, maybeSource)
從輸入建立一個Result
實例,該實例可能是像{ err?, data? }
、 Error
實例或只是data
。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
結果 | 對象|錯誤|混合的 | 真的 | ||
也許錯誤 | 錯誤 | 真的 | ||
也許來源 | 細繩 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 結果 |
constructor(err , data , source )
Result
類別建構函數。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
犯錯 | 錯誤 | 無效的 | 真的 | |
數據 | 目的 | 無效的 | 真的 | |
來源 | 細繩 | 不明確的 | 真的 |
length()
計算結果長度。
ready()
等待本機 IPC 層準備好並在全域視窗物件上公開。
sendSync(command, params)
透過 XHR 發送同步 IPC 命令,並在成功或錯誤時傳回Result
。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
命令 | 細繩 | 錯誤的 | ||
參數 | 對象|細繩 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 結果 |
emit(name, value, target , options)
發出要在window
物件上分派的事件。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
姓名 | 細繩 | 錯誤的 | ||
價值 | 混合 | 錯誤的 | ||
目標 | 事件目標 | 窗戶 | 真的 | |
選項 | 目的 | 真的 |
resolve(seq, value)
透過seq
解析具有可能值的請求。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
序列 | 細繩 | 錯誤的 | ||
價值 | 混合 | 錯誤的 |
send(command, value)
發送帶有參數的非同步 IPC 命令請求。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
命令 | 細繩 | 錯誤的 | ||
價值 | 混合 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
write(command, params, buffer, options)
發送帶有參數和緩衝位元組的非同步 IPC 命令請求。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
命令 | 細繩 | 錯誤的 | ||
參數 | 目的 | 真的 | ||
緩衝 | 緩衝器|類型數組 |數組緩衝區 |字串|大批 | 真的 | ||
選項 | 目的 | 真的 |
request(command, params, options)
發送帶有參數的非同步 IPC 命令請求,請求帶有緩衝位元組的回應。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
命令 | 細繩 | 錯誤的 | ||
參數 | 目的 | 真的 | ||
選項 | 目的 | 真的 |
createBinding(domain, ctx)
用於建立基於代理的 IPC API 的工廠。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
領域 | 細繩 | 錯誤的 | ||
ctx | 功能|目的 | 真的 | ||
ctx.預設值 | 細繩 | 真的 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 代理人 |
此模組提供來自所有主要作業系統的標準化系統資訊。
arch()
這是os.js
中名為arch
的FunctionDeclaration
,它已匯出但未記錄。
networkInterfaces()
這是os.js
中名為networkInterfaces
的FunctionDeclaration
,它已匯出但未記錄。
platform()
這是os.js
中名為platform
FunctionDeclaration
,它已匯出但未記錄。
type()
這是os.js
中名為type
的FunctionDeclaration
,它已匯出但未記錄。
isWindows()
這是os.js
中名為isWindows
的FunctionDeclaration
,它已匯出但未記錄。
tmpdir()
這是os.js
中名為tmpdir
的FunctionDeclaration
,它已匯出但未記錄。
這是os.js
中名為EOL
的VariableDeclaration
,它已匯出但未記錄。
這是path/path.js
中名為Path
ClassDeclaration
,它已匯出但未記錄。
cwd(opts)
計算路徑的目前工作目錄
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選擇 | 目的 | 真的 | ||
opts.posix 設定為true 以強制 POSIX 樣式路徑 | 布林值 | 真的 |
constructor(opts)
Path
類構造函數。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選擇 | 目的 | 真的 | ||
選項根目錄 | 細繩 | 真的 | ||
選項庫 | 細繩 | 真的 | ||
選擇名稱 | 細繩 | 真的 | ||
選項目錄 | 細繩 | 真的 | ||
選擇.ext | 細繩 | 真的 |
resolve()
normalize()
homedir()
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 細繩 | 目前使用者的主目錄。 |
exit(code)
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
程式碼 | 數位 | 0 | 真的 | 退出代碼。預設值:0。 |
提供運行時特定的方法
這是runtime.js
中名為currentWindow
的VariableDeclaration
,它已匯出但未記錄。
這是一個在runtime.js
中名為debug
的VariableDeclaration
,它已匯出但未記錄。
這是一個在runtime.js
中名為config
的VariableDeclaration
,它已匯出但未記錄。
send()
這是一個在runtime.js
中名為send
的FunctionDeclaration
,它已匯出但未記錄。
getWindows()
這是runtime.js
中名為getWindows
FunctionDeclaration
,它已匯出但未記錄。
openExternal()
這是runtime.js
中名為openExternal
FunctionDeclaration
,它已匯出但未記錄。
exit(options)
退出後端進程,然後退出渲染進程,使用的退出代碼是作業系統的最終退出代碼。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選項 | 目的 | 錯誤的 | 一個選項對象 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
setTitle(options)
設定視窗的標題(如果適用)。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選項 | 目的 | 錯誤的 | 一個選項對象 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | Promise<ipc.Result> |
inspect()
這是一個在runtime.js
中名為inspect
的FunctionDeclaration
,它已匯出但未記錄。
show(opts)
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選擇 | 目的 | 錯誤的 | 一個選項對象 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | Promise<ipc.Result> |
hide(opts)
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選擇 | 目的 | 錯誤的 | 一個選項對象 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | Promise<ipc.Result> |
navigate(opts)
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選擇 | 目的 | 錯誤的 | 一個選項對象 | |
選擇視窗 | 數位 | 目前視窗 | 錯誤的 | 視窗的索引 |
選項.url | 數位 | 錯誤的 | 要載入到視窗中的 HTML 檔案的路徑 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | Promise<ipc.Result> |
setWindowBackgroundColor()
這是runtime.js
中名為setWindowBackgroundColor
的FunctionDeclaration
,它已匯出但未記錄。
setContextMenu(options)
開啟本機上下文選單。
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選項 | 目的 | 錯誤的 | 一個選項對象 |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
setSystemMenuItemEnabled()
這是runtime.js
中名為setSystemMenuItemEnabled
的FunctionDeclaration
,它已匯出但未記錄。
setSystemMenu(options)
設定應用程式的本機選單。
Socket Runtime 提供了極簡的 DSL,可輕鬆建立跨平臺本機系統和上下文選單。
選單是在運行時創建的。它們可以從主程序或渲染程序建立。可以透過呼叫setSystemMenu
方法立即重新建立它們。
該方法需要一個字串。這是菜單的範例。分號很重要,表示菜單的結尾。當沒有加速鍵時使用下劃線。修飾符是可選的。眾所周知的作業系統選單選項(例如編輯選單)將自動取得加速器,您無需指定它們。
socket . runtime . setSystemMenu ( { index : 0 , value : `
App:
Foo: f;
Edit:
Cut: x
Copy: c
Paste: v
Delete: _
Select All: a;
Other:
Apple: _
Another Test: T
!Im Disabled: I
Some Thing: S + Meta
---
Bazz: s + Meta, Control, Alt;
` )
若要建立分隔符,請使用三個破折號---
。
加速鍵修飾符用作視覺指示器,但不會產生實質影響,因為實際的鍵綁定是在事件偵聽器中完成的。
大寫字母表示加速器是透過Shift
鍵修改的。
其他加速器有Meta
、 Control
、 Option
,每個加速器都用逗號分隔。如果一個不適用於某個平台,它將被忽略。
在 MacOS 上Meta
與Command
相同。
如果您想要停用某個選單項,只需在該選單項目前加上!
特點。這將導致該項目在系統選單呈現時顯示為停用。
我們覺得巢狀菜單是一種反模式。我們不使用它們。如果您對它們有強有力的論據,並且有一個非常簡單的拉取請求,可以使它們發揮作用,我們可能會考慮它們。
當選單項目被啟動時,它會在前端程式碼中引發menuItemSelected
事件,然後您可以根據需要與後端程式碼進行通訊。
例如,如果從Other
選單中選擇Apple
項目...
window . addEventListener ( 'menuItemSelected' , event => {
assert ( event . detail . parent === 'Other' )
assert ( event . detail . title === 'Apple' )
} )
爭論 | 類型 | 預設 | 選修的 | 描述 |
---|---|---|---|---|
選項 | 目的 | 錯誤的 | 一個選項對象 | |
選項.值 | 細繩 | 錯誤的 | 選單佈局 | |
選項索引 | 數位 | 錯誤的 | 目標視窗(如果適用) |
傳回值 | 類型 | 描述 |
---|---|---|
未指定 | 承諾 |
reload()
這是一個位於runtime.js
中名為reload
的FunctionDeclaration
,它已匯出但未記錄。