net disposable http server

標準ライブラリについて...

私たちは、Web が数値計算に最適な環境になる未来を信じています。この未来の実現を支援するために、私たちは stdlib を構築しました。 stdlib は、数値計算および科学計算に重点を置いた標準ライブラリであり、ブラウザおよび Node.js で実行するために JavaScript (および C) で書かれています。

このライブラリは完全に分解可能であり、正確な好みやユースケースに合わせて API と機能を交換したり組み合わせたりできるように設計されています。

stdlib を使用すると、世の中で最も綿密で、厳格で、よく書かれ、調査、文書化、テスト、測定された高品質のコードを使用していることを確信できます。

数値コンピューティングの Web への導入に参加するには、まず 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 : Web ブラウザを起動するかどうかを示す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

インストール

一般的なユーティリティとして使用するには、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
...

---

知らせ

このパッケージは、JavaScript および Node.js の標準ライブラリである stdlib の一部であり、数値計算および科学計算に重点を置いています。このライブラリは、数学、統計、ストリーム、ユーティリティなどのための堅牢で高性能なライブラリのコレクションを提供します。

プロジェクトの詳細、バグ レポートや機能リクエストの提出、stdlib の開発方法に関するガイダンスについては、メイン プロジェクト リポジトリを参照してください。

コミュニティ

---

ライセンス

「ライセンス」を参照してください。

著作権

著作権 © 2016-2024。 Stdlib の作者。