net disposable http server

關於標準庫...

我們相信未來網路將成為數值運算的首選環境。為了幫助實現這個未來，我們建立了 stdlib。 stdlib 是一個標準函式庫，重點是數值和科學計算，用 JavaScript（和 C）編寫，可在瀏覽器和 Node.js 中執行。

該程式庫是完全可分解的，其架構可讓您交換、混合和匹配 API 和功能，以滿足您的確切偏好和用例。

當您使用 stdlib 時，您可以絕對確定您正在使用最徹底、最嚴格、編寫良好、經過研究、記錄、測試、測量和高品質的程式碼。

要與我們一起將數值計算帶入網絡，請先在 GitHub 上查看我們，並考慮在經濟上支援 stdlib。我們非常感謝您一如既往的支持！

一次性 HTTP 伺服器

建立一次性 HTTP 伺服器。

安裝

npm install @stdlib/net-disposable-http-server

用法

 var httpServer = require ( '@stdlib/net-disposable-http-server' ) ; 

httpServer( 選項[, clbk] )

創建一次性 HTTP 伺服器；即，伺服器在提供所提供的內容後立即關閉。

 var opts = {
    'html' : '<script src="/bundle.js"></script>' ,
    'javascript' : 'console.log( "Boop" );'
} ;

httpServer ( opts ) ;

函數接受以下選項：

• html ：用作 HTML 內容的buffer或string 。
• javascript ：用作 JavaScript 的buffer或string 。
• 連接埠：伺服器連接埠。預設值： 0 （即隨機分配）。
• maxport ：最大伺服器連接埠（連接埠搜尋時使用）。預設值： =port 。
• 主機名稱：伺服器主機名稱。
• 位址：伺服器位址。預設值： "0.0.0.0" 。
• open ： boolean指示是否啟動網頁瀏覽器。預設值： false 。

若要提供 HTML 內容，請設定html選項。一旦請求內容，伺服器將關閉。

 var opts = {
    'html' : '<h1>Beep</h1>'
} ;

httpServer ( opts ) ;

若要提供 JavaScript，請設定javascript選項。如果未提供 HTML，則會提供 HTML 樣板，而 JavaScript 將作為/bundle.js提供。一旦請求內容，伺服器將關閉。

 var opts = {
    'javascript' : 'console.log( "Boop" );'
} ;

httpServer ( opts ) ;

如果提供了 HTML 和 JavaScript，為了提供 JavaScript，HTML 內容應請求檔案/bundle.js 。

 var opts = {
    'html' : '<script src="/bundle.js"></script>' ,
    'javascript' : 'console.log( "Boop" );'
} ;

httpServer ( opts ) ;

若要取得server句柄，請提供回呼。

 var nextTick = require ( '@stdlib/utils-next-tick' ) ;

function onReady ( error , server ) {
    if ( error ) {
        throw error ;
    }
    nextTick ( close ) ;
    function close ( ) {
        server . close ( ) ;
    }
}

var opts = {
    'html' : html ,
    'javascript' : 'console.log( "Boop" );'
} ;

httpServer ( opts , onReady ) ; 

筆記

• 如果html或javascript選項都未設置，伺服器將提供 HTML 樣板，然後關閉。

範例

 var join = require ( 'path' ) . join ;
var readFileSync = require ( '@stdlib/fs-read-file' ) . sync ;
var httpServer = require ( '@stdlib/net-disposable-http-server' ) ;

var html = join ( __dirname , 'examples' , 'fixtures' , 'index.html' ) ;
var js = join ( __dirname , 'examples' , 'fixtures' , 'script.js' ) ;

var opts = {
    'html' : readFileSync ( html ) ,
    'javascript' : readFileSync ( js ) ,
    'port' : 7331 ,
    'hostname' : 'localhost' ,
    'open' : false
} ;

httpServer ( opts , clbk ) ;

function clbk ( error , server ) {
    if ( error ) {
        throw error ;
    }
    // Give the user a few seconds to open her web browser before closing the server...
    setTimeout ( onTimeout , 5000 ) ;

    function onTimeout ( ) {
        server . close ( ) ;
    }
} 

---

命令列介面

安裝

若要用作通用實用程序，請全域安裝 CLI 軟體包

npm install -g @stdlib/net-disposable-http-server-cli

用法

 Usage: temp-http-server [options] (--html path | --js path | --stdin type)

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.
         --html path           Serve HTML.
  --js,  --javascript path     Serve JavaScript.
         --stdin type          Type of content: html or javascript.
  -p,    --port port           Server port. Default: 0.
         --maxport maxport     Max server port. Default: `port`.
         --hostname hostname   Server hostname.
         --address address     Server address. Default: 0.0.0.0.
         --open                Launch a browser once server is ready.

該應用程式識別以下環境變數：

• DEBUG ：啟用詳細日誌記錄。
• PORT ：伺服器連接埠。
• MAXPORT ：最大伺服器連接埠。
• HOSTNAME ：伺服器主機名稱。
• ADDRESS ：伺服器位址。

筆記

• 命令列參數始終優先於環境變數。
• 如果設定了--html或--javascript命令列標誌，則假定stdin為另一種類型。因此， --stdin標誌可以被省略。

範例

若要提供 HTML 文件，

$ DEBUG= * temp-http-server --html ./examples/fixtures/index.html
...

要提供 JavaScript 檔案（和預設的 HTML 樣板），

$ DEBUG= * temp-http-server --javascript ./examples/fixtures/script.js
...

除了文件輸入之外，應用程式還接受標準輸入。要管道 HTML，

$ cat ./examples/fixtures/index.html | DEBUG= * temp-http-server --port 7331 --stdin html
...

要透過管道傳輸 HTML 並載入 JavaScript 文件，

$ cat ./examples/fixtures/index.html | DEBUG= * temp-http-server --port 7331 --javascript ./examples/fixtures/script.js
...

要透過管道傳遞 JavaScript（並提供預設的 HTML 樣板），

$ cat ./examples/fixtures/script.js | DEBUG= * temp-http-server --address ' 127.0.0.1 ' --stdin javascript
...

要透過管道傳遞 JavaScript 並提供請求/bundle.js檔案的自訂 HTML 內容，

$ cat ./examples/fixtures/script.js | DEBUG= * temp-http-server --html ./examples/fixtures/index.html
...

---

注意

該軟體包是 stdlib 的一部分，stdlib 是 JavaScript 和 Node.js 標準庫，重點關注數值和科學計算。該庫提供了一系列強大的高效能庫，用於數學、統計、流、實用程式等。

有關該專案的更多資訊、提交錯誤報告和功能請求以及如何開發 stdlib 的指南，請參閱主專案儲存庫。

社群

---

執照

請參閱許可證。

版權

版權所有 © 2016-2024。 Stdlib 作者。