API / SDK / developer guide
OPCUAClient
| 目標讀者 TA | TypeScript 用戶端開發者 |
|---|---|
| 官方文件能力 | 建立用戶端、連線並管理工作階段。 |
| 輸入 → 輸出 | 端點／安全選項 → 用戶端與工作階段生命週期。 |
| 執行環境 | Node.js TypeScript／JavaScript。 |
| 本站選型評估 | 透過公開用戶端選項設定安全。 |
| 本站建議驗證 | 驗證斷線清理與重連狀態。 |
工業 IoT／SCADA · SDK / protocol
NodeOPCUA
NodeOPCUA Project
用 Node.js 與 TypeScript 串接 OPC UA。
使用文件公開 API 並固定套件版本。目前文件描述 2.184.0 的 ESM 轉換；內部安全通道符號可能在公開 API 保證之外變動。
NODEOPCUA / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 專案 | NodeOPCUA 是模組化 TypeScript OPC UA 通訊堆疊，用於建立工業用戶端、伺服器與資訊模型。Sterfive 在社群專案之外提供專業支援。 |
|---|---|
| 開發者適用性 | 適合需要具型別工業資料交換及自行控制 OPC UA 工作階段的 Node.js 團隊。目前儲存庫要求 Node.js 22.13 或更新版本。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源；未執行真實 API、推論或效能測試。預期結果為建議內部契約。
十項技術入口比較
依開發任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · OPCUAClientAPI / SDK / developer guide | 建立用戶端、連線並管理工作階段。TypeScript 用戶端開發者 |
| 02 · OPCUAServerAPI / SDK / developer guide | 提供 OPC UA 服務與自訂模型。工業閘道作者 |
| 03 · AddressSpaceAPI / SDK / developer guide | 管理伺服器命名空間與資訊模型。資訊模型工程師 |
| 04 · ClientSessionAPI / SDK / developer guide | 讀取、寫入、瀏覽及呼叫方法。資料擷取開發者 |
| 05 · NodeIdAPI / SDK / developer guide | 表示節點識別碼。轉接與結構開發者 |
| 06 · VariantAPI / SDK / developer guide | 承載 OPC UA 純量或陣列值。具型別遙測實作者 |
| 07 · DataValueAPI / SDK / developer guide | 一併保留值、狀態與時間戳。重視品質的遙測使用者 |
| 08 · Role-based security guideAPI / SDK / developer guide | 將使用者及角色對應至允許操作。伺服器授權設計者 |
| 09 · Reverse Connect guideAPI / SDK / developer guide | 實作 OPC UA 反向連線建立。受網路限制的整合團隊 |
| 10 · ESM migration guideAPI / SDK / developer guide | 為 ESM 轉換調整 TypeScript／模組設定。升級相依套件的團隊 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
OPCUAServer
| 目標讀者 TA | 工業閘道作者 |
|---|---|
| 官方文件能力 | 提供 OPC UA 服務與自訂模型。 |
| 輸入 → 輸出 | 伺服器選項與模型 → 端點生命週期。 |
| 執行環境 | Node.js 伺服器。 |
| 本站選型評估 | 初始化與啟動為不同生命週期步驟。 |
| 本站建議驗證 | 檢查已初始化模型、端點及關閉資源。 |
API / SDK / developer guide
AddressSpace
| 目標讀者 TA | 資訊模型工程師 |
|---|---|
| 官方文件能力 | 管理伺服器命名空間與資訊模型。 |
| 輸入 → 輸出 | 節點集／模型定義 → 位址空間物件。 |
| 執行環境 | 伺服器端模型 API。 |
| 本站選型評估 | 命名空間識別是節點解讀的一部分。 |
| 本站建議驗證 | 驗證瀏覽路徑、型別及模型版本。 |
API / SDK / developer guide
ClientSession
| 目標讀者 TA | 資料擷取開發者 |
|---|---|
| 官方文件能力 | 讀取、寫入、瀏覽及呼叫方法。 |
| 輸入 → 輸出 | 服務要求 → 具型別結果／狀態碼。 |
| 執行環境 | 有效 OPC UA 工作階段。 |
| 本站選型評估 | 工作階段成功不代表每個操作成功。 |
| 本站建議驗證 | 檢查個別操作狀態與分頁／延續需求。 |
API / SDK / developer guide
NodeId
| 目標讀者 TA | 轉接與結構開發者 |
|---|---|
| 官方文件能力 | 表示節點識別碼。 |
| 輸入 → 輸出 | 識別碼型別、命名空間與值 → NodeId。 |
| 執行環境 | 共用 TypeScript 資料物件。 |
| 本站選型評估 | 顯示名稱不是唯一節點識別碼。 |
| 本站建議驗證 | 完整往返驗證識別碼及命名空間。 |
API / SDK / developer guide
Variant
| 目標讀者 TA | 具型別遙測實作者 |
|---|---|
| 官方文件能力 | 承載 OPC UA 純量或陣列值。 |
| 輸入 → 輸出 | 資料型別、值與陣列中繼資料 → Variant。 |
| 執行環境 | TypeScript 通訊協定值物件。 |
| 本站選型評估 | 單靠 JavaScript 數值無法指定 OPC UA 數值型別。 |
| 本站建議驗證 | 檢查範圍、陣列形狀及明確資料型別。 |
API / SDK / developer guide
DataValue
| 目標讀者 TA | 重視品質的遙測使用者 |
|---|---|
| 官方文件能力 | 一併保留值、狀態與時間戳。 |
| 輸入 → 輸出 | Variant 加品質／時間欄位 → DataValue。 |
| 執行環境 | 用戶端／伺服器資料交換。 |
| 本站選型評估 | 缺少時間戳不代表資料最新。 |
| 本站建議驗證 | 區分不良／不確定狀態與有效零值。 |
API / SDK / developer guide
Role-based security guide
| 目標讀者 TA | 伺服器授權設計者 |
|---|---|
| 官方文件能力 | 將使用者及角色對應至允許操作。 |
| 輸入 → 輸出 | 使用者／角色政策 → 存取決策。 |
| 執行環境 | NodeOPCUA 伺服器設定。 |
| 本站選型評估 | 身分驗證與節點授權須分別驗證。 |
| 本站建議驗證 | 逐角色驗證允許讀取與拒絕寫入。 |
API / SDK / developer guide
Reverse Connect guide
| 目標讀者 TA | 受網路限制的整合團隊 |
|---|---|
| 官方文件能力 | 實作 OPC UA 反向連線建立。 |
| 輸入 → 輸出 | 伺服器／用戶端反向連線設定 → 傳輸建立。 |
| 執行環境 | 參與連線的 NodeOPCUA 端點。 |
| 本站選型評估 | 反向傳輸不會免除憑證及工作階段檢查。 |
| 本站建議驗證 | 驗證重連行為及對端識別。 |
API / SDK / developer guide
ESM migration guide
| 目標讀者 TA | 升級相依套件的團隊 |
|---|---|
| 官方文件能力 | 為 ESM 轉換調整 TypeScript／模組設定。 |
| 輸入 → 輸出 | 既有建置設定 → 相容匯入／建置。 |
| 執行環境 | Node.js 與 TypeScript 工具鏈。 |
| 本站選型評估 | 指南指出 2.184.0 套件轉換；須固定安裝版本。 |
| 本站建議驗證 | 建置實際應用並檢查模組解析錯誤。 |
Generated public API
| TA | 升級 NodeOPCUA 的維護者 |
|---|---|
| 本站驗證建議 | 使用文件公開 API；重新匯出的內部符號不受公開語意版本契約保障。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
NodeOPCUA 轉接契約示意；未執行連線、伺服器部署或設備操作。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
成功具型別讀取
| 輸入 | 讀取示意溫度 Value 屬性。 |
|---|---|
| 預期結果 | 內部 Double 值為 23.0，status_code=Good，並保留供應的時間戳。 |
| 驗收條件 | DataValue 品質與數值內容分開保存。 |
空瀏覽頁
| 輸入 | 成功瀏覽不含參照亦無延續點。 |
|---|---|
| 預期結果 | 內部 status=empty、references=[]。 |
| 驗收條件 | 仍有延續點時不得推論完整空結果。 |
授權失敗
| 輸入 | 唯讀使用者要求受保護的寫入。 |
|---|---|
| 預期結果 | 內部錯誤保留伺服器操作狀態；applied=false。 |
| 驗收條件 | 不得宣稱變數或機器狀態已改變。 |
工作階段遺失
| 輸入 | 資料收集期間連線結束。 |
|---|---|
| 預期結果 | 內部 status=disconnected；最後讀值標為過期。 |
| 驗收條件 | 確認工作階段恢復後才繼續；揭露觀測中斷。 |
將預期結果對應至你的應用
整合後將實際 SDK 或服務回應對應至此建議內部契約。下列識別碼與數值均為示意；不含憑證或真實請求。
預期輸出 JSON — 示意，非實測 · NodeOPCUA-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "NodeOPCUA",
"status": "ok",
"input_id": "sample-001",
"data": {
"node_id": "ns=2;s=Example.Temperature",
"data_type": "Double",
"value": 23.0,
"status_code": "Good",
"source_timestamp": null,
"server_timestamp": null
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果解讀 | 傳輸或執行成功不代表模型準確。有效空結果須與操作失敗分開。 |
|---|---|
| 可重現性 | 記錄模型、環境、設定與輸入識別；代表性測試前約定品質及延遲條件。不宣稱已實測效能。 |
| 操作範圍 | NodeOPCUA 轉接契約示意；未執行連線、伺服器部署或設備操作。 |
開發評估
Node.js 工廠資料閘道
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
串接前置條件
使用文件公開 API 並固定套件版本。目前文件描述 2.184.0 的 ESM 轉換；內部安全通道符號可能在公開 API 保證之外變動。
開發順序
- 確認 NodeOPCUA 的存取、授權與支援版本。
- 準備上述樣本，針對「Node.js 工廠資料閘道」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。