نام (NAME)

rhino - پوسته JavaScript را برای اجرای اسکریپت‌ها در حالت دسته‌ای یا تعاملی فراخوانی می‌کند

خلاصه دستور (SYNOPSIS)

rhino [options] script_filename_or_url [script_arguments]

توضیحات (DESCRIPTION)

این صفحهٔ راهنما به طور مختصر دستور rhino را شرح می‌دهد.

rhino یک اسکریپت آغازگر برای پوسته JavaScript رینو (Rhino) است که روشی ساده برای اجرای اسکریپت‌ها در حالت دسته‌ای یا در یک محیط تعاملی جهت برنامه‌نویسی اکتشافی فراهم می‌کند.

گزینه‌ها (OPTIONS)

-debug: تولید اطلاعات اشکال‌زدایی. این گزینه سطح بهینه‌سازی را روی صفر تنظیم می‌کند.
-e script_source: مقدار script_source را به عنوان یک اسکریپت JavaScript اجرا می‌کند.
-encoding characterEncoding: تنظیم کدگذاری نویسه‌ها (character encoding) برای مواردی که قابل تشخیص نباشد.
-f script_filename_or_url: محتوای script_filename_or_url را خوانده و آن را به عنوان یک اسکریپت JavaScript اجرا می‌کند.
-fatal-warnings: در نظر گرفتن هشدارها به عنوان خطا.
-help, -?: نمایش راهنما.
-modules module: افزودن یک ماژول به مسیر (path).
-opt, -O optLevel: بهینه‌سازی در سطح optLevel، که باید یک عدد صحیح بین 0 و 9 باشد.
-require: استفاده از ()require.
-sandbox: نمونه‌های ساخته‌شده require() در محیط ایزوله (sandboxed) اجرا خواهند شد.
-sealedlib: استفاده از یک کتابخانهٔ استاندارد مهروموم‌شده (sealed).
-strict: فعال‌سازی حالت سخت‌گیرانه (strict mode).
-version versionNumber: نسخهٔ زبان را برای کامپایل مشخص می‌کند. مقدار باید یکی از 100، 110، 120، 130، 140، 150، 160، 170، 180 یا 200 باشد.
-w: گزارش هشدارها.

ویژگی‌های از پیش تعریف‌شده (PREDEFINED PROPERTIES)

اسکریپت‌هایی که در پوسته اجرا می‌شوند به برخی از ویژگی‌های اضافی شیء سطح بالا (top-level) دسترسی دارند.

arguments: شیء arguments آرایه‌ای شامل رشته‌های تمامی آرگومان‌هایی است که هنگام فراخوانی پوسته در خط فرمان داده شده‌اند.
help(): اجرای تابع help پیام‌های نحوه استفاده و راهنما را چاپ می‌کند.
defineClass(className): تعریف یک افزونه با استفاده از کلاس Java که با آرگومان رشته‌ای className مشخص شده است. برای تعریف افزونه از ScriptableObject.defineClass() استفاده می‌کند.
deserialize(filename): بازیابی شیئی از فایل مشخص‌شده که قبلاً با فراخوانی serialize نوشته شده است.
load([filename,...]): بارگذاری فایل‌های منبع JavaScript که با آرگومان‌های رشته‌ای مشخص شده‌اند. اگر چندین آرگومان داده شود، هر فایل به نوبت خوانده و اجرا می‌شود.
loadClass(className): بارگذاری و اجرای کلاسی که با آرگومان رشته‌ای className مشخص شده است. این کلاس باید کلاسی باشد که رابط Script را پیاده‌سازی می‌کند، درست مانند هر اسکریپت دیگری که توسط jsc کامپایل شده باشد.
print([expr...]): ارزیابی و چاپ عبارات. هر عبارت را ارزیابی کرده، نتیجه را به رشته تبدیل می‌کند و آن را چاپ می‌نماید.
readFile(path[,characterCoding]): فایل داده‌شده را می‌خواند و بایت‌های آن را با استفاده از کدگذاری نویسه مشخص‌شده، یا کدگذاری پیش‌فرض در صورت عدم تعیین آرگومان کدگذاری صریح، به یک رشته تبدیل می‌کند.
readUrl(url[,characterCoding]): یک اتصال ورودی به رشته آدرس url داده‌شده باز می‌کند، تمام بایت‌های آن را می‌خواند و با استفاده از کدگذاری نویسه مشخص‌شده یا کدگذاری پیش‌فرض (در صورت عدم تعیین آرگومان کدگذاری صریح) به یک رشته تبدیل می‌کند.
runCommand(commandName,[arg,...][options]): دستور مشخص‌شده را با آرگومان و گزینه‌های داده‌شده به عنوان یک فرایند جداگانه اجرا می‌کند و وضعیت خروج فرایند را برمی‌گرداند. برای جزئیات، به مستندات JavaDoc مربوط به org.mozilla.javascript.tools.shell.Global#runCommand مراجعه کنید.
setTimeout(function[,delay,arg,...]): تابع "function" را پس از "delay" میلی‌ثانیه اجرا می‌کند. (اگر "delay" تعیین نشده باشد، روی 0 تنظیم می‌شود.) پارامترهای بعدی به عنوان آرگومان به آن پاس داده می‌شوند. وقفه‌ها پس از پایان اجرای تابع جاری اجرا می‌شوند و در پوستهٔ تعاملی، تنها پس از خروج از پوسته اجرا خواهند شد. یک شناسه (ID) برمی‌گرداند که می‌تواند به "clearTimeout" ارسال شود.
clearTimeout(id): لغو وقفه‌ای که با استفاده از "setTimeout" تنظیم شده است.
serialize(object,filename): سریال‌سازی شیء داده‌شده در فایل مشخص‌شده.
spawn(functionOrScript): اجرای تابع یا اسکریپت داده‌شده در یک ریسهٔ (thread) جداگانه.
sync(function): یک تابع همگام‌شده (به مفهوم متد synchronized در Java) از روی یک تابع موجود می‌سازد. تابع جدید روی شیء this مربوط به فراخوانی خود همگام‌سازی می‌شود.
quit(): خروج از پوسته. در صورت وارد کردن نویسه پایان فایل (EOF) در اعلان، پوسته در حالت تعاملی نیز خارج خواهد شد.
version([number]): دریافت یا تنظیم شماره نسخهٔ JavaScript. اگر هیچ آرگومانی ارائه نشود، شماره نسخهٔ فعلی برگردانده می‌شود. اگر آرگومانی ارسال شود، باید یکی از 100، 110، 120، 130، 150، 160، 170، 180 یا 200 باشد تا به ترتیب نسخه‌های JavaScript 1.0، 1.1، 1.2، 1.3، 1.4، 1.5، 1.6، 1.7، 1.8 یا ECMAScript 6 را مشخص کند.
write([expr...]): ارزیابی و چاپ عبارات همانند "print"، اما بدون رفتن به خط جدید در انتها.
console: شیء console یک کنسول اشکال‌زدایی ساده مشابه شیء console ارائه‌شده در مرورگرهای وب فراهم می‌کند.

console.log(format[arg,...]): برای خروجی عمومی اطلاعات لاگ‌گیری (logging). جایگزینی رشته و آرگومان‌های اضافی پشتیبانی می‌شوند. متن قالب‌بندی‌شده را مطابق با format و args ارائه‌شده با پیشوند "INFO" چاپ می‌کند. این تابع با console.info(format[arg,...]) یکسان است.
console.trace(format[arg,...]): این تابع با console.log(format[arg,...]) یکسان است، با این تفاوت که پیشوند "TRACE" را به جای "INFO" چاپ می‌کند.
console.debug(format[arg,...]): این تابع با console.log(format[arg,...]) یکسان است، با این تفاوت که پیشوند "DEBUG" را به جای "INFO" چاپ می‌کند.
console.info(format[arg,...]): این تابع با console.log(format[arg,...]) یکسان است.
console.warn(format[arg,...]): این تابع با console.log(format[arg,...]) یکسان است، با این تفاوت که پیشوند "WARN" را به جای "INFO" چاپ می‌کند.
console.error(format[arg,...]): این تابع با console.log(format[arg,...]) یکسان است، با این تفاوت که پیشوند "ERROR" را به جای "INFO" چاپ می‌کند.
console.assert(expression[arg,...]): در صورتی که expression نادرست (false) باشد، خطا چاپ می‌کند. در صورت ارائه args، آن‌ها نیز چاپ خواهند شد.
console.count([label]): شمارندهٔ مربوط به label را که از صفر شروع می‌شود یکی افزایش داده و برچسب و مقدار را پس از افزایش چاپ می‌کند. اگر label تعیین نشود، "default" به عنوان برچسب در نظر گرفته می‌شود.
console.countReset([label]): شمارندهٔ مربوط به label را به صفر بازنشانی می‌کند. اگر label تعیین نشود، "default" به عنوان برچسب در نظر گرفته می‌شود.
console.time([label]): یک زمان‌سنج برای label آغاز می‌کند. برای متوقف کردن زمان‌سنج و چاپ زمان سپری‌شده از console.timeEnd([label]) استفاده کنید. برای چاپ زمان سپری‌شده بدون توقف زمان‌سنج از console.timeLog([label]) استفاده کنید.
console.timeLog([label]): به console.time([label]) مراجعه کنید.
console.timeEnd([label]): به console.time([label]) مراجعه کنید.

همچنین ببینید (SEE ALSO)

مستندات برخط بایگانی‌شده در https://developer.mozilla.org/en-US/docs/Mozilla/Projects/Rhino/Shell

نویسندگان (AUTHORS)

این صفحهٔ راهنما توسط Wolfgang Baer <WBaer@gmx.de> نوشته شده است؛ برای تغییرات بعدی به تاریخچه Git مراجعه کنید.