تنزيل net disposable http server - تنزيل رمز مصدر net disposable http server

net disposable http server

فئات أخرى

1.0.0

تنزيل

حول ستليب...

نحن نؤمن بمستقبل يكون فيه الويب بيئة مفضلة للحسابات الرقمية. للمساعدة في تحقيق هذا المستقبل، قمنا ببناء stdlib. stdlib هي مكتبة قياسية، مع التركيز على الحساب العددي والعلمي، مكتوبة بلغة JavaScript (و C) للتنفيذ في المتصفحات وفي Node.js.

المكتبة قابلة للتحلل بالكامل، حيث تم تصميمها بحيث يمكنك تبديل واجهات برمجة التطبيقات والوظائف ومزجها ومطابقتها لتلبية تفضيلاتك وحالات الاستخدام المحددة.

عند استخدام stdlib، يمكنك التأكد تمامًا من أنك تستخدم التعليمات البرمجية الأكثر دقة وصرامة وكتابة جيدة ودراسة وتوثيقًا واختبارها وقياسها وعالية الجودة.

للانضمام إلينا في جلب الحوسبة الرقمية إلى الويب، ابدأ بمراجعتنا على GitHub، ويرجى التفكير في دعم stdlib ماليًا. نحن نقدر بشدة دعمكم المستمر!

خادم HTTP يمكن التخلص منه

حالة البناء

قم بإنشاء خادم HTTP يمكن التخلص منه.

تثبيت

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

الاستخدام

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

خادم http( خيارات[, clbk] )

إنشاء خادم HTTP يمكن التخلص منه؛ أي يتم إغلاق الخادم فورًا بعد تقديم المحتوى المقدم.

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

httpServer ( opts ) ;

تقبل الوظيفة الخيارات التالية:

html : buffer أو string لتكون بمثابة محتوى HTML.
جافا سكريبت : buffer أو string لتكون بمثابة جافا سكريبت.
المنفذ : منفذ الخادم. الافتراضي: 0 (أي يتم تعيينه بشكل عشوائي).
maxport : أقصى منفذ للخادم (يستخدم عند صيد المنافذ). الافتراضي: =port .
اسم المضيف : اسم مضيف الخادم.
العنوان : عنوان الخادم. الافتراضي: "0.0.0.0" .
مفتوح : boolean يشير إلى ما إذا كان سيتم تشغيل متصفح الويب أم لا. الافتراضي: false .

لعرض محتوى HTML، قم بتعيين خيار html . بمجرد طلب المحتوى، سيتم إغلاق الخادم.

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

httpServer ( opts ) ;

لخدمة جافا سكريبت، قم بتعيين خيار 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 وتقديم محتوى HTML مخصص يطلب ملف /bundle.js ،

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

يلاحظ

هذه الحزمة جزء من مكتبة stdlib القياسية لـ JavaScript وNode.js، مع التركيز على الحوسبة الرقمية والعلمية. توفر المكتبة مجموعة من المكتبات القوية وعالية الأداء للرياضيات والإحصاء والتدفقات والمرافق والمزيد.

لمزيد من المعلومات حول المشروع، وتقديم تقارير الأخطاء وطلبات الميزات، والإرشادات حول كيفية تطوير stdlib، راجع مستودع المشروع الرئيسي.