عرض مصدر Node.js/repl

<noinclude>{{DISPLAYTITLE:الوحدة REPL في Node.js}}</noinclude>
الاستقرار: 2-مستقر 

تقدّم الوحدة <code>repl</code> تطبيق قراءة وتقييم وطباعة حلقة تكرار والذي يكون متوافرًا كبرنامج بحد ذاته (مستقل) أو مُتَضمّن في تطبيق آخر. يمكن الوصول إليه باستخدام:<syntaxhighlight lang="javascript">
const repl = require('repl');
</syntaxhighlight>

=== التصميم والميزات ===
تُصدِّر الوحدة <code>repl</code> الصنف [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]] أثناء التنفيذ، سوف تقبل نسخ [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]] أسطرًا مفردةً من دخل المستخدم وتقيّمها تبعًا لدوال تقييم معرّفة من المستخدم ومن ثمّ تخرج الناتج. ربما يكون الدخل والخرج من <code>stdin</code> و <code>stdout</code>، على التوالي، ربما تكون متصلة بأي مجرى ([[Node.js/stream|stream]]) يتبع لبرمجية Node.js.

تدعم نُسخ [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]] الإكمال التلقائي للدخل، وتعديل سطري بنمط برمجية Emacs‏ (Emacs-style) البسيط، ودخل متعدد الأسطر، و خرج بأسلوب ANSI-styled، وحفظ واستعادة حالة جلسة REPL الحالية، وإصلاح الأخطاء، ودوال تقييم قابلة للتخصيص.

==== أوامر ومفاتيح خاصة ====
الأوامر الخاصة التالية مدعومة من قبل كل نُسخ  REPL:
* ‎<code>.break</code>: في عملية إدخال تعبير متعدد الأسطر، سوف يوقف إدخال الأمر ‎.break (أو الضغط على مجموعة المفاتيح ‎<code><ctrl>‎-‎C</code>‎) الدخل الإضافي أو معالجة ذاك التعبير.
* <code>‎.clear</code>: يعيد ضبط قيمة REPL <code>context</code> إلى كائن فارغ ويمسح أي تعابير متعددة الأسطر تُدخل حاليًا.
* <code>‎.exit</code>: يغلق مجرى الدخل/الخرج (I/O)، متسبّبًا بخروج REPL.
* <code>‎.help</code>: يظهر هذه القائمة من الأوامر الخاصة.
* <code>‎.save</code>: يحفظ جلسة REPL الحالية إلى ملف: <code>‎>‎ ‎.save ./file/to/save.js‎</code>
* <code>‎.load</code>: يحمّل ملفًا إلى جلسة REPL الحالية. <code>‎> ‎.‎load ./file/to/load.js</code>‎
* <code>‎.editor</code>: يدخل وضع التعديل (للانتهاء <code>‎<ctrl>‎-‎D</code>‎، وللإلغاء ‎<code><ctrl>‎-‎C</code>)
<syntaxhighlight lang="javascript">
> .editor


 //( ^C وللإلغاء ^D دخول وضع التعديل (للانتهاء 

function welcome(name) {
  return `Hello ${name}!`;
}

welcome('Node.js User');

// ^D
'Hello Node.js User!'
>

</syntaxhighlight>

يملك المزيج التالي من المفاتيح في REPL هذه التأثيرات الخاصة:
* ‎<code><ctrl>‎‎-‎‎C</code>‎: عندما تُضغط مرّة، فإنها تملك ذات التأثير كأمر <code>‎.break</code> .عندما تُضغط مرّتين على سطر فارغ، تملك ذات تأثير أمر <code>‎.exit</code>
* ‎<code><ctrl>‎-‎D</code>: تملك ذات تأثير أمر <code>‎.exit</code>
* <code>‎<tab></code>‎: عندما تُضغط على سطر فارغ، تعرض المتحولات العامة والمحلية (النطاق). عندما تُضغط أثناء ادخال دخل آخر، تعرض خيارات إكمال تلقائي ذات صلة.

==== التقييم الإفتراضي ====
بشكل افتراضي، تستخدم كل نسخ [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]] دالة تقييم والتي تقيّم تعابير JavaScript وتوفّر وصول إلى وحدات Node.js مُدمجة. يمكن أن يُعاد تعريف هذا السلوك الافتراضي بتمرير دالة تقييم بديلة عندما تُنشأ نسخة [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]].

===== تعابير JavaScript =====
يدعم المقيّم الافتراضي تقييم مباشر لتعابير JavaScript:<syntaxhighlight lang="javascript">
> 1 + 1
2
> const m = 2
undefined
> m + 1
3

</syntaxhighlight>

إلّا إذا وسِّع من خلال كتل برمجية أو دوال، يُصرّح عن المتحولات المصرّح عنها في النطاق العام إما بشكل ضمني أو باستخدام الكلمات المفتاحية <code>const</code> أو <code>let</code> أو <code>var</code>.

===== النطاق العام والمحلي =====
يوفّر المقيّم الافتراضي وصولًا إلى أي متحول موجود في النطاق العام. من الممكن استخراج متحول إلى REPL بشكل صريح بإسناده إلى كائن <code>context</code> مترافق مع كل <code>REPLServer</code>:<syntaxhighlight lang="javascript">
const repl = require('repl');
const msg = 'message';

repl.start('> ').context.m = msg;

</syntaxhighlight>تظهر الخاصيات في كائن <code>context</code> كمحلية ضمن REPL:<syntaxhighlight lang="javascript">
$ node repl_test.js
> m
'message'
</syntaxhighlight>

خاصيات السياق Context افتراضيًا ليست للقراءة-فقط، لتحديد قراءة-فقط على النطاق العام، يجب أن تُعرّف خاصيات السياق باستخدام <code>Object.defineProperty()</code>‎:<syntaxhighlight lang="javascript">
const repl = require('repl');
const msg = 'message';

const r = repl.start('> ');
Object.defineProperty(r.context, 'm', {
  configurable: false,
  enumerable: true,
  value: msg
});



</syntaxhighlight>

===== الوصول إلى نواة وحدات Node.js =====
سوف يحمّل المقيّم الافتراضي تلقائيًا الوحدات الأساسية في Node.js إلى بيئة REPL عندما تُستخدم. على سبيل المثال، إلّا إذا صرّح عنها كمتحولات عامة أو متحولات نطاق. سوف يُقيّم الدخل <code>fs</code> عند الطلب كما يلي ‎<code>global.fs = require('fs')</code>‎:<syntaxhighlight lang="javascript">
> fs.createReadStream('./some/file');
</syntaxhighlight>

===== الاستثناءات العامة غير الملتقطة =====
يستخدم REPL وحدة [[Node.js/domain|domain]] لإلتقاط كل الاستثناءات غير المُلتقطة من أجل جلسة REPL تلك.

يشتمل استخدام وحدة [[Node.js/domain|domain]] في REPL على هذه الآثار الجانبية:
* الاستثناءات غير الملتقطة لا تطلق حدث [[Node.js/process#.D8.A7.D9.84.D8.AD.D8.AF.D8.AB .27uncaughtException.27|'uncaughtException']].
* ترمي محاولة استخدام [[Node.js/process#process.setUncaughtExceptionCaptureCallback.28fn.E2.80.8E.29.E2.80.8E|process.setUncaughtExceptionCaptureCallback()]]‎ الخطأ [[Node.js/errors#ERR DOMAIN CANNOT SET UNCAUGHT EXCEPTION CAPTURE.E2.80.8E|ERR_DOMAIN_CANNOT_SET_UNCAUGHT_EXCEPTION_CAPTURE]].

===== إسناد المتحول '_' (underscore) =====
سجل التغييرات
{| class="wikitable"
!الإصدار
!التغييرات
!
!
|-
|التغييرات
|أضيف دعم ‎<code>_‎error</code>
|
|
|-
|
|
|
|
|-
|
|
|
|
|}
بشكل افتراضي، سوف يسند المقيّم الافتراضي قيمة أحدث تعبير مُقيّم إلى المتحول الخاص <code>_</code> (شرطة سفلية). ضبط <code>_</code> بشكل صريح إلى قيمة ما سوف يعطّل هذا السلوك.<syntaxhighlight lang="javascript">
> [ 'a', 'b', 'c' ]
[ 'a', 'b', 'c' ]
> _.length
3
> _ += 1
Expression assignment to _ now disabled.
4
> 1 + 1
2
> _
4
</syntaxhighlight>بشكل مشابه، سوف يشير <code>‎_‎error</code>‎ إلى آخر خطأ مُشاهد، إذا وُجِد. ضبط <code>‎_‎error‎</code> إلى قيمةٍ ما بشكل صريح سوف يعطّل هذا السلوك.<syntaxhighlight lang="javascript">
> throw new Error('foo');
Error: foo
> _error.message
'foo'
</syntaxhighlight>

===== الكلمة المفتاحية <code>await</code> =====
مع خيار سطر الأوامر المُحدد [[Node.js/cli#.E2.80.8E--experimental-repl-await|‎--experimental‎-repl-await‎]] ، مُكّن الدعم التجريبي للكلمة المفتاحية <code>await</code>.<syntaxhighlight lang="javascript">
> await Promise.resolve(123)
123
> await Promise.reject(new Error('REPL await'))
Error: REPL await
    at repl:1:45
> const timeout = util.promisify(setTimeout);
undefined
> const old = Date.now(); await timeout(1000); console.log(Date.now() - old);
1002
undefined

</syntaxhighlight>

==== دوال تقييم مُخصصة ====
عندما تُنشأ نسخة جديدة من الكائن [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]] جديدة، ربما تُقدّم دوال تقييم مخصصة. يمكن أن يستخدم هذا على سبيل المثال، لتنفيذ تطبيقات REPL مخصصة بشكل كامل.

يشرح التالي مثال REPL نظري والذي ينجز ترجمةً لنص من لغة إلى أخرى:<syntaxhighlight lang="javascript">
const repl = require('repl');
const { Translator } = require('translator');

const myTranslator = new Translator('en', 'fr');

function myEval(cmd, context, filename, callback) {
  callback(null, myTranslator.translate(cmd));
}

repl.start({ prompt: '> ', eval: myEval });

</syntaxhighlight>

===== أخطاء يمكن إصلاحها =====
بما أنَّ المستخدم يكتب المدخلات ضمن مِحَث REPL، سوف يرسل ضغطُ المفتاح ‎<code><enter></code>‎ سطرَ المدخلات الحالية إلى دالة <code>eval</code>. بغية دعم المدخلات متعدد الأسطر، يمكن أن تعيد الدالة evalنسخة من الصنف <code>repl.Recoverable</code> إلى دالة رد النداء المتوافرة:<syntaxhighlight lang="javascript">
function myEval(cmd, context, filename, callback) {
  let result;
  try {
    result = vm.runInThisContext(cmd);
  } catch (e) {
    if (isRecoverableError(e)) {
      return callback(new repl.Recoverable(e));
    }
  }
  callback(null, result);
}

function isRecoverableError(error) {
  if (error.name === 'SyntaxError') {
    return /^(Unexpected end of input|Unexpected token)/.test(error.message);
  }
  return false;
}

</syntaxhighlight>

==== تخصيص خرج REPL ====
افتراضيًا، تنسِّق النسخ [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]] الخرج باستخدام التابع [[Node.js/util#util.inspect.28object.5B.2Coptions.5D.29.E2.80.8E .D9.88 util.inspect.28object.5B.2C showHidden.5B.2C depth.5B.2C colors.5D.5D.5D.29.E2.80.8E|util.inspect()]]‎ قبل كتابة الخرج إلى المجرى <code>Writable</code> المُقدّم (يكون <code>process.stdout</code> افتراضيًا). يمكن أن يُحدَّد الخيار <code>useColors</code> المنطقي عند البناء ليأمر الكاتب الافتراضي باستخدام النمط ANSI المستعمل في تنسيق الشيفرات لتلوين خرج التابع <code>util.inspect()‎</code>.

من الممكن تخصيص خرج النسخة [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]] بشكل كامل عن طريق تمرير دالة جديدة إليه باستخدام الخيار <code>writer</code> عند البناء. على سبيل المثال، يحوّل المثال التالي أي نص مدخل إلى حالة الأحرف الكبيرة:<syntaxhighlight lang="javascript">
const repl = require('repl');

const r = repl.start({ prompt: '> ', eval: myEval, writer: myWriter });

function myEval(cmd, context, filename, callback) {
  callback(null, cmd);
}

function myWriter(output) {
  return output.toUpperCase();
}
</syntaxhighlight>

=== الصنف <code>REPLServer</code> ===
أضيف في الإصدار: 0.1.91

يرث الصنف <code>repl.REPLServer</code> من الصنف [[Node.js/readline#.D8.A7.D9.84.D8.B5.D9.86.D9.81: Interface|readline.Interface]]. تُنشَأ النُسخ <code>repl.REPLServer</code> باستخدام التابع <code>repl.start()</code>‎ ولا ينبغي أن تُنشَأ بشكل مباشر باستخدام كلمة JavaScript المفتاحية <code>new</code>.

==== الحدث <code>'exit'</code> ====
أضيف في الإصدار: 0.7.7.

يُطلق الحدث <code>'exit'</code> عندما يُنهَى REPL إمّا باستقبال أمر ‎<code>.exit</code>‎ كدخل، أو بضغط المستخدم على المفتاحين ‎<code><ctrl>‎-‎C</code> مرتين لإرسال الإشارة <code>SIGINT</code>، أو بضغط المفتاحين ‎<code><ctrl>‎-‎D</code> لإطلاق الحدث <code>'end'</code> في مجرى الدخل. سيُستدعى تابع  رد نداء المستمع (listener callback) دون أي وسائط.<syntaxhighlight lang="javascript">
replServer.on('exit', () => {
  console.log('Received "exit" event from repl!');
  process.exit();
});

</syntaxhighlight>

==== الحدث: <code>'reset'</code> ====
أضيف في الإصدار: 0.11.0

يُطلق الحدث <code>'reset'</code> عندما يُعاد ضبط سياق REPL. يحصل هذا عندما يُستقبَل الأمر <code>‎.clear</code>‎ كدخل إلّا إذا كانت REPL تستخدم المقيّم (evaluator) الإفتراضي وأُنشأَت نسخة من الصنف <code>repl.REPLServer</code> مع ضبط الخيار <code>useGlobal</code> إلى القيمة <code>true</code>. ستُستدعى دالة رد نداء المستمع مع مرجعٍ يشير إلى كائن <code>context</code>، إذ يعدُّ هذا المرجع وسيطها الوحيد.

يمكن أن يُستخدم هذا في المقام الأول لإعادة تهيئة سياق REPL لبعض الحالات المحددة مسبقًا:<syntaxhighlight lang="javascript">
const repl = require('repl');

function initializeContext(context) {
  context.m = 'test';
}

const r = repl.start({ prompt: '> ' });
initializeContext(r.context);

r.on('reset', initializeContext);
</syntaxhighlight>عندما تُنفّذ هذه الشيفرة، يمكن أن يُعدَّل المتغير <code>'m'</code> العام ولكن يعاد بعد ذلك لقيمته الإبتدائية باستخدام الأمر <code>‎.clear</code>‎:<syntaxhighlight lang="javascript">
$ ./node example.js
> m
'test'
> m = 1
1
> m
1
> .clear
Clearing context...
> m
'test'
>

</syntaxhighlight>

==== <code>replServer.defineCommand(keyword, cmd)‎</code> ====
أضيف في الإصدار: 0.3.0.
* <code>keyword</code>: ‏‎[[JavaScript/String|<string>]]‎ الكلمة المفتاحية للأمر (دون المحرف <code>.</code> الافتتاحي).
* <code>Cmd</code>:‏ [[JavaScript/Object|‎<Object>]]‎ | [[JavaScript/Function|<Function>]]‎ الدالة المراد استدعاؤها عندما يُعالَج الأمر.
يُستخدَم التابع <code>replServer.defineCommand()</code>‎ لإضافة أمر جديد مسبوق بنقطة <code>.</code> إلى نسخة REPL. تُستدعى مثل هذه الأوامر بكتابة <code>.</code> متبوعة بالكلمة <code>keyword</code>. تكون <code>cmd</code> إمّا <code>Function</code> أو <code>Object</code> مع الخاصيات التالية:
* <code>help</code>:‏ [[JavaScript/String|<string>]] نص مساعدة المراد عرضه عندما يُكتَب <code>‎.help</code> (اختياري).
* <code>action</code>:‏ [[JavaScript/Function|<Function>]] الدالة المراد تنفيذها. تقبل اختياريًا سلسلة نصية كوسيط وحيد.
يُظهِر المثال التالي أمرين جديدين مضافين إلى نسخة REPL:<syntaxhighlight lang="javascript">
const repl = require('repl');

const replServer = repl.start({ prompt: '> ' });
replServer.defineCommand('sayhello', {
  help: 'Say hello',
  action(name) {
    this.clearBufferedCommand();
    console.log(`Hello, ${name}!`);
    this.displayPrompt();
  }
});
replServer.defineCommand('saybye', function saybye() {
  console.log('Goodbye!');
  this.close();
});

</syntaxhighlight>يمكن أن تُستخدم هذه التعليمات من داخل النسخة REPL نفسها:<syntaxhighlight lang="javascript">
> .sayhello Node.js User
Hello, Node.js User!
> .saybye
Goodbye!
</syntaxhighlight>

==== <code>replServer.displayPrompt([preserveCursor‎]‎)‎</code> ====
أضيف في الإصدار: 0.1.91.
* <code>preserveCursor</code>:‏ [[JavaScript/Boolean|<boolean>]]
يُعِدُّ التابع <code>replServer.displayPrompt()</code>‎ نسخة REPL لاستقبال المدخلات من المستخدم، ثم طباعة <code>prompt</code> بعد ضبطه إلى سطر جديد في الخرج <code>output</code> ثم استئناف الدخل <code>input</code> لقبول مدخلات جديدة.

عندما تكون المدخلات متعدد الأسطر، يُطبع علامة الحذف (...) بدلًا من 'prompt'.

عندما تكون قيمة <code>preserveCursor</code> هي <code>true</code>، لن يعاد ضبط موضع المؤشر إلى <code>0</code>.

الغرض من التابع <code>replServer.displayPrompt</code> في المقام الأول هو استدعاؤه من داخل دالة الإجراء (action function) لأجل الأوامر المُسجلَة باستخدام التابع <code>replServer.defineCommand()</code>‎.

==== <code>replServer.clearBufferedCommand()‎</code> ====
أضيف في الإصدار: 9.0.0.

يمسح التابع <code>replServer.clearBufferedCommand()</code>‎ أي أوامر خُزّنت مؤقتًا ولكنَّها لم تُنفّذ بعد. الغرض من هذا التابع في المقام الأول هو استدعاؤه من داخل دالة الإجراء (action function) لأجل الأوامر المُسجلَة باستخدام التابع <code>replServer.defineCommand()‎</code>.

==== <code>replServer.parseREPLKeyword(keyword[, rest]‎)</code>‎ ====
الاستقرار: 0-مهمل.

أضيف في الإصدار: 0.8.9.أهمل منذ الإصدار: 9.0.0.
* <code>keyword</code>:‏ [[JavaScript/String|<string>]] الكلمة المفتاحية المرتقبة للتحليل والتنفيذ.
* <code>rest</code>:‏ [[dfgsgf|<any>]] أي معاملات للكلمة المفتاحية keyword.
* القيمة المعادة: ‎[[JavaScript/Boolean|<boolean>‎]]
تابع داخلي يُستخدَم لتحليل وتنفيذ كلمات <code>REPLServer</code> المفتاحية. يعيد القيمة  <code>true</code> إذا كانت الكلمة المفتاحية <code>keyword</code> صالحة، وإلّا سيعيد القيمة <code>false</code>.

=== <code>repl.start([options]‎)‎</code> ===
سجل التغييرات
{| class="wikitable"
!الإصدار
!التغييرات
!
!
|-
|10.0.0
|أزيل الخيار <code>REPL_MAGIC_MODE replMode</code>
|
|
|-
|5.8.0
|أصبح المعامل <code>options</code> اختياريًا الآن.
|
|
|-
|0.1.91
|أُضيف هذا التابع.
|
|
|}
* <code>options</code>:‏ ‎ [[JavaScript/Object|<Object>]]‎ | [[JavaScript/String|<string>‎‎]]
** <code>prompt</code>:‏ [[JavaScript/String|<string>]] مِحثّ الإدخال المراد إظهاره. '''القيمة الإفتراضية:''' <code>‎'‎>‎ '‎‎</code> (مع مسافة زائدة)
** <code>input</code>:‏ [[dfgfgds|<stream.Readable>]] المجرى <code>Readable</code> الذي سيُقرأ منه دخل REPL. '''القيمة الإفتراضية:''' <code>process.stdin</code>.
** <code>output</code>:‏ [[dfzdsg|<stream.Writable>]] المجرى <code>Writable</code> الذي سيكتب إليه خرج REPL. '''القيمة الافتراضية:''' <code>process.stdout</code>.
** <code>terminal</code>:‏ [[JavaScript/Boolean|<boolean>]] قيمة منطقية إذا كانت <code>true</code>، تحدِّد أنّ <code>output</code> ينبغي أن يُعامل كطرفية TTY، ويمتلك شيفرات هروب ANSI/VT100 مكتوبة له. '''القيمة الافتراضية''' له تعتمد على قيمة الخاصية <code>isTTY</code> على المجرى <code>output</code>.
** <code>eval</code>:‏ [[JavaScript/Function|<Function>]] الدالة التي ستُستخدم عند تقييم كل سطر مُعطَى من الدخل. القيمة الإفتراضية هي: مغلف (wrapper) غير متزامن للدالة <code>eval()‎</code> الموجودة في JavaScript. يمكن أن تخطئ دالة eval مع <code>repl.Recoverable</code> لتشير إلى أنَّ الدخل غير مُكتمل وتُظهر أسطر إضافية.
** <code>useColors</code>:‏ [[JavaScript/Boolean|<boolean>]] قيمة منطقية إذا كانت <code>true</code>، تشير إلى أنَّ الدالة <code>writer</code> الافتراضية ينبغي أن تتضمن نمط الألوان ANSI في خرج REPL. إذا أعطيت دالة writer مُخصَّصة، فليس لهذا الخيار عند ذلك أي تأثير. '''القيمة الإفتراضية''': قيمة النُسَخ <code>terminal</code> في REPL.
** <code>useGlobal</code>:‏ [[JavaScript/Boolean|<boolean>]] قيمة منطقية إذا كانت <code>true</code>، فستشير إلى أنّ تابع التقييم الافتراضي سيستخدم global التي تخص JavaScript كسياق في مقابل إنشاء سياق منفصل جديد لنسخة REPL. تضبط العقدة CLI REPL هذه القيمة إلى <code>true</code>. '''القيمة الافتراضية:''' <code>false</code>.
** <code>ignoreUndefined</code>:‏ [[JavaScript/Boolean|<boolean>]] قيمة منطقية إذا كانت <code>true</code>، فستشير إلى أنَّ الكاتب الافتراضي لن يُظهِر قيمة الأمر المُعادة إذا قُيّمت على أنَّها غير معرّفة (<code>undefined</code>). '''القيمة الافتراضية:''' <code>false</code>.
** <code>writer</code>:‏ [[JavaScript/Function|<Function>]] دالة يراد استدعاؤها لتنسيق المخرجات لكل أمر قبل كتابته إلى الخرج <code>output</code>.'''القيمة الافتراضية:''' [[Node.js/util#util.inspect.28object.5B.2Coptions.5D.29.E2.80.8E .D9.88 util.inspect.28object.5B.2C showHidden.5B.2C depth.5B.2C colors.5D.5D.5D.29.E2.80.8E|util.inspect()‎]].
** <code>completer</code>:‏ [[JavaScript/Function|<Function>]] دالة اختيارية تُستخدم للإكمال التلقائي عبر المفتاح Tap. انظر التابع [[sdkfl\lfkjs|readline.InterfaceCompleter]] على سبيل المثال.
** <code>replMode</code>:‏ [[JavaScript/symbol|<symbol>]] راية تحدِّد فيما اذا كان المقيّم الافتراضي ينفذ كل أوامر JavaScript في النمط الصارم أو النمط الافتراضي (المتساهل). القيم المقبولة لاستعمالها مع الخيار هي:
*** <code>repl.‎REPL_MODE_SLOPPY‎</code>: تقيّم التعابير في النمط المتساهل.
*** <code>repl.‎REPL_MODE_STRICT</code>‎: تقيّم التعابير في النمط الصارم. هذا مكافئ لاستهلال كل عبارة repl بالعبارة <code>'use strict'</code>.
** <code>breakEvalOnSigint</code>‎: يوقف تقييم القطعة الحالية من الشيفرة عند استقبال الإشارة <code>SIGINT</code>، أي ضُغِطَ المفتاحان <code>Ctrl+C</code>. لايمكن أن يُستخدَم هذا الخيار في نفس الوقت مع الخيار <code>eval</code>. '''القيمة الافتراضية''' هي: <code>false</code>.
يُنشئ التابع <code>repl.start()</code>‎ ويبدأ النسخة [[Node.js/repl#.D8.A7.D9.84.D8.B5.D9.86.D9.81 REPLServer|repl.REPLServer]].

إذا كان المعامل <code>options</code> سلسلةً نصيةً (string)، فسيُحدِّد محثّ الإدخال:<syntaxhighlight lang="javascript">
const repl = require('repl');

// نمط محث يونيكس
repl.start('$ ');

</syntaxhighlight>

=== الوحدة REPL في Node.js  ===
تستخدم Node.js بحدِّ ذاتها الوحدة <code>repl</code> لتوفير واجهة تفاعلية لها لتنفيذ JavaScript. يمكن أن يستخدم هذا عن طريق تنفيذ شيفرة Node.js التنفيذية دون تمرير أي وسائط (أو بتمرير الوسيط <code>‎-i‎</code>):<syntaxhighlight lang="javascript">
$ node
> const a = [1, 2, 3];
undefined
> a
[ 1, 2, 3 ]
> a.forEach((v) => {
...   console.log(v);
...   });
1
2
3

</syntaxhighlight>

==== خيارات متحولات البيئة ====
يمكن تخصيص سلوكيات الوحدة REPL في Node.js باستخدام متغيرات البيئة التالية:
* <code>NODE_REPL_HISTORY</code>: عندما يُعطى مسار صالح، سيُحفظ تاريخ REPL الدائم إلى الملف الذي يشير إليه هذا المسار بدلًا من حفظه في المجلد <code>‎‎.‎node_repl_history‎</code> في المجلد home للمستخدم. ضبط هذه القيمة إلى <code>' '</code> سوف يعطّل تاريخ REPL الدائم. ستُزال المسافات البيضاء من القيمة.
* <code>NODE_REPL_HISTORY_SIZE</code>: يتحكم بعدد أسطر التاريخ (history) التي ستُحفَظ اذا كان التاريخ متوافرًا. يجب أن تكون عددًا موجبًا. '''القيمة الافتراضية''' هي: <code>1000</code>
* <code>NODE_REPL_MODE</code>: إمّا أن تكون <code>'sloppy'</code> أو <code>'strict'</code>. '''القيمة الافتراضية:''' <code>'sloppy'</code>، والتي ستسمح بتنفيذ شيفرات النمط غير الصارم.

==== التاريخ الدائم ====
افتراضيًّا، ستبقي Node.js REPL التاريخ بين جلسات <code>node</code> REPL عن طريق حفظ المدخلات إلى المف <code>‎.‎node_repl_history</code> المتوضع في المجلد home للمستخدم. يمكن أن يُعطَّل ذلك بضبط متغير البيئة بالشكل <code>NODE_REPL_HISTORY‎=‎<nowiki>''</nowiki>‎</code>.

==== استخدام Node.js REPL مع محرر سطري متقدم ====
من أجل محررات الأسطر المتقدّمة، ابدأ Node.js مع متغير البيئة <code>NODE_NO_READLINE=1</code> . هذا سوف يبدأ main والمنقّح (debugger)‏ الذي يخص REPL في إعدادات طرفية معيارية، والتي ستسمح بالاستخدام مع <code>rlwrap</code>.

فمثلًا، يمكن أن يُضاف السطر التالي إلى الملف ‎<code>.‎bashrc‎</code>:<syntaxhighlight lang="javascript">
alias node="env NODE_NO_READLINE=1 rlwrap node"
</syntaxhighlight>

==== بدء عدّة نسخ REPL مقابل نسخة شغالة وحيدة ====
من الممكن إنشاء وتشغيل عدة نُسخ REPL مقابل نسخة Node.js شغّالة وحيدة والتي تشارك كائن <code>global</code> وحيد ولكن تمتلك عدة واجهات دخل/خرج (I/O).

على سبيل المثال، يوفر المثال التالي وحدات REPL مستقلة على مجرى الدخل القياسي <code>stdin</code>، ومقبس يونكس والمقبس TCP:<syntaxhighlight lang="javascript">
const net = require('net');
const repl = require('repl');
let connections = 0;

repl.start({
  prompt: 'Node.js via stdin> ',
  input: process.stdin,
  output: process.stdout
});

net.createServer((socket) => {
  connections += 1;
  repl.start({
    prompt: 'Node.js via Unix socket> ',
    input: socket,
    output: socket
  }).on('exit', () => {
    socket.end();
  });
}).listen('/tmp/node-repl-sock');

net.createServer((socket) => {
  connections += 1;
  repl.start({
    prompt: 'Node.js via TCP socket> ',
    input: socket,
    output: socket
  }).on('exit', () => {
    socket.end();
  });
}).listen(5001);

</syntaxhighlight>تشغيل هذا التطبيق من موجه الأوامر يؤدي إلى بدء REPL على مجرى الدخل القياسي (stdin). يمكن أيضًا أن يتصل عملاء REPL الآخرون عبر مقبس يونكس أو المقبس TCP.

على سبيل المثال، يفيد <code>telnet</code> في الاتصال بمقابس TCP، بينما يمكن أن يُستخدم <code>socat</code> للاتصال بمقبس يونكس ومقبس TCP كلاهما.

ببدء REPL من خادم يعتمد على مقبس يونكس بدلًا من مجرى الدخل القياسي، يمكن الاتصال بعملية Node.js شغالة لمدة طويلة دون إعادة تشغيلها.

مثالٌ عن تشغيل طرفيةREPL (<code>terminal</code>)‎ "كاملة المواصفات" عبر النسخة <code>net.Server</code> والنسخة <code>net.Socket</code>، تجده في [https://gist.github.com/TooTallNate/2209310 هذه] الصفحة. مثالٌ آخر عن تشغيل نسخة REPL عبر [http://man7.org/linux/man-pages/man1/curl.1.html curl(1)‎]، تجده في [https://gist.github.com/TooTallNate/2053342 هذه] الصفحة.

=== مصادر ===
[https://nodejs.org/dist/latest-v10.x/docs/api/repl.html صفحة REPL في توثيق Node.js الرسمي.]
[[تصنيف:Node.js]]