JRUNSCRIPT(1)                     دستورات JDK                    JRUNSCRIPT(1)

نام (NAME)
       jrunscript-openjdk21 - شل خط فرمانی اسکریپت‌نویسی جاوا در OpenJDK 21

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

       این ابزار آزمایشی بوده و پشتیبانی نمی‌شود.

       jrunscript [گزینه‌ها] [آرگومان‌ها]

       گزینه‌ها
              نشان‌دهنده گزینه‌های خط فرمان قابل استفاده برای دستور jrunscript
              است.  بخش گزینه‌ها (OPTIONS) را ببینید.

       آرگومان‌ها
              آرگومان‌ها در صورت استفاده، بلافاصله پس از گزینه‌ها یا نام دستور
              قرار می‌گیرند.  بخش آرگومان‌ها را ببینید.

توضیحات (DESCRIPTION)
       دستور jrunscript یک شل خط فرمانی اسکریپت‌نویسی مستقل از زبان است.  دستور
       jrunscript از هر دو حالت تعاملی (read-eval-print) و حالت دسته‌ای (با
       گزینه -f) برای اجرای اسکریپت‌ها پشتیبانی می‌کند.  به‌طور پیش‌فرض از زبان
       جاوااسکریپت (JavaScript) استفاده می‌شود، اما با استفاده از گزینه -l
       می‌توان زبان دیگری را تعیین کرد.  دستور jrunscript با برقراری ارتباط
       میان جاوا و زبان اسکریپت‌نویسی، از سبک برنامه‌نویسی اکتشافی پشتیبانی
       می‌کند.

       در صورت استفاده از جاوااسکریپت، دستور jrunscript پیش از ارزیابی اسکریپت
       کاربر، توابع و اشیاء درونی خاصی را مقداردهی اولیه می‌کند که در مشخصات
       API مربوط به توابع درونی جاوااسکریپت در jrunscript مستند شده‌اند.

گزینه‌ها (OPTIONS)
       -cp path یا -classpath path
              محل قرارگیری فایل‌های کلاسی (class files) که اسکریپت برای دسترسی
              به آن‌ها نیاز دارد را مشخص می‌کند.

       -Dname=value
              یک ویژگی سیستمی جاوا (Java system property) را مقداردهی می‌کند.

       -Jflag فلگ flag را مستقیماً به ماشین مجازی جاوا (JVM) که دستور
              jrunscript روی آن در حال اجرا است ارسال می‌کند.

       -l language
              از زبان اسکریپت‌نویسی مشخص‌شده استفاده می‌کند.  به‌طور پیش‌فرض،
              جاوااسکریپت استفاده می‌شود.  برای استفاده از سایر زبان‌های
              اسکریپت‌نویسی، باید فایل JAR موتور اسکریپت‌نویسی مربوطه را با
              گزینه -cp یا -classpath مشخص کنید.

       -e script
              اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند.  از این گزینه می‌توان
              برای اجرای اسکریپت‌های تک‌خطی که کاملاً در خط فرمان مشخص شده‌اند
              استفاده کرد.

       -encoding encoding
              کدگذاری نویسه‌های مورداستفاده برای خواندن فایل‌های اسکریپت را مشخص
              می‌کند.

       -f script-file
              فایل اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند (حالت دسته‌ای).

       -f -   وارد حالت تعاملی می‌شود تا اسکریپت را از ورودی استاندارد بخواند و
              ارزیابی کند.

       -help یا -?
              پیام راهنما را نمایش داده و خارج می‌شود.

       -q     فهرست تمام موتورهای اسکریپت‌نویسی موجود را نمایش داده و خارج
              می‌شود.

آرگومان‌ها (ARGUMENTS)
       اگر آرگومان‌هایی مشخص شوند و از هیچ‌یک از گزینه‌های -e یا -f استفاده نشده
       باشد، آرگومان اول فایل اسکریپت در نظر گرفته شده و سایر آرگومان‌ها (در
       صورت وجود) به عنوان آرگومان‌های اسکریپت ارسال می‌شوند.  اگر آرگومان‌ها
       همراه با گزینه -e یا -f استفاده شوند، تمامی آرگومان‌ها به عنوان
       آرگومان‌های اسکریپت ارسال خواهند شد.  اگر آرگومان‌ها و همچنین گزینه‌های -e
       و -f مشخص نشوند، از حالت تعاملی استفاده می‌شود.

مثال‌های اجرای اسکریپت‌های درون‌خطی (EXAMPLES)

              jrunscript -e "print('hello world')"

              jrunscript -e "cat('http://www.example.com')"

مثال استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت

              jrunscript -l js -f test.js

مثال حالت تعاملی

              jrunscript
              js> print('Hello World\n');
              Hello World
              js> 34 + 55
              89.0
              js> t = new java.lang.Thread(function() { print('Hello World\n'); })
              Thread[Thread-0,5,main]
              js> t.start()
              js> Hello World

              js>


اجرای فایل اسکریپت با آرگومان‌های اسکریپت
       در این مثال، فایل test.js فایل اسکریپت است.  آرگومان‌های arg1، arg2 و
       arg3 به اسکریپت ارسال می‌شوند.  اسکریپت می‌تواند از طریق آرایه arguments
       به این آرگومان‌ها دسترسی پیدا کند.

              jrunscript test.js arg1 arg2 arg3

JDK 21                               2023                        JRUNSCRIPT(1)