.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JRUNSCRIPT" "1" "2026" "JDK 25.0.4.1" "JDK Commands"
.SH "نام (NAME)"
jrunscript \- اجرای یک پوستهٔ اسکریپت خط فرمانی با پشتیبانی از حالت‌های تعاملی و دسته‌ای
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]نکته:\f[R]
.PP
این ابزار \f[B]آزمایشی\f[R] است و پشتیبانی نمی‌شود.
این ابزار منسوخ شده است و در نسخه‌های آینده حذف خواهد شد.
.PP
\f[CR]jrunscript\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
.TP
\f[I]options\f[R]
بیانگر گزینه‌های خط فرمانی قابل استفاده در \f[CR]jrunscript\f[R] است.
بخش \f[B]گزینه‌های دستور JRUNSCRIPT (OPTIONS FOR THE JRUNSCRIPT COMMAND)\f[R] را ببینید.
.TP
\f[I]arguments\f[R]
آرگومان‌ها، در صورت استفاده، بلافاصله پس از گزینه‌ها یا نام دستور قرار می‌گیرند.
بخش \f[B]آرگومان‌ها (ARGUMENTS)\f[R] را ببینید.
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]jrunscript\f[R] یک پوستهٔ اسکریپت خط فرمانی مستقل از زبان است.
دستور \f[CR]jrunscript\f[R] هم از حالت تعاملی (read\-eval\-print) و هم از حالت دسته‌ای (گزینهٔ \f[CR]\-f\f[R]) برای اجرای اسکریپت پشتیبانی می‌کند.
به‌طور پیش‌فرض، JavaScript زبان مورد استفاده است، اما با استفاده از گزینهٔ \f[CR]\-l\f[R] می‌توان زبان دیگری را مشخص کرد.
دستور \f[CR]jrunscript\f[R] از طریق برقراری ارتباط میان جاوا و زبان اسکریپت‌نویسی، از شیوهٔ برنامه‌نویسی اکتشافی پشتیبانی می‌کند.
.PP
در صورت استفاده از JavaScript، دستور \f[CR]jrunscript\f[R] پیش از ارزیابی اسکریپت تعریف‌شده توسط کاربر، توابع و اشیاء توکار (built\-in) خاصی را مقداردهی اولیه می‌کند که در مشخصات API توابع توکار JavaScript در \f[CR]jrunscript\f[R] مستند شده‌اند.
.SH "گزینه‌های دستور JRUNSCRIPT (OPTIONS FOR THE JRUNSCRIPT COMMAND)"
.TP
\f[CR]\-cp\f[R] \f[I]path\f[R] یا \f[CR]\-classpath\f[R] \f[I]path\f[R]
مسیر فایل‌های کلاسی (class files) را که اسکریپت نیاز به دسترسی به آن‌ها دارد مشخص می‌کند.
.TP
\f[CR]\-D\f[R]\f[I]name\f[R]\f[CR]=\f[R]\f[I]value\f[R]
یک مشخصهٔ سیستمی جاوا (Java system property) را تنظیم می‌کند.
.TP
\f[CR]\-J\f[R]\f[I]flag\f[R]
گزینهٔ \f[I]flag\f[R] را مستقیماً به ماشین مجازی جاوا (JVM) که دستور \f[CR]jrunscript\f[R] در آن اجرا می‌شود ارسال می‌کند.
.TP
\f[CR]\-l\f[R] \f[I]language\f[R]
از زبان اسکریپت‌نویسی مشخص‌شده استفاده می‌کند.
به‌طور پیش‌فرض، از JavaScript استفاده می‌شود.
برای استفاده از سایر زبان‌های اسکریپت‌نویسی، باید فایل JAR مربوط به موتور اسکریپت آن را با گزینهٔ \f[CR]\-cp\f[R] یا \f[CR]\-classpath\f[R] مشخص کنید.
.TP
\f[CR]\-e\f[R] \f[I]script\f[R]
اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند.
این گزینه می‌تواند برای اجرای اسکریپت‌های تک‌خطی که به‌طور کامل در خط فرمان وارد شده‌اند استفاده شود.
.TP
\f[CR]\-encoding\f[R] \f[I]encoding\f[R]
کدگذاری نویسه‌ها (character encoding) را که برای خواندن فایل‌های اسکریپت استفاده می‌شود مشخص می‌کند.
.TP
\f[CR]\-f\f[R] \f[I]script\-file\f[R]
فایل اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند (حالت دسته‌ای).
.TP
\f[CR]\-f \-\f[R]
برای خواندن و ارزیابی اسکریپت از ورودی استاندارد (standard input)، وارد حالت تعاملی می‌شود.
.TP
\f[CR]\-help\f[R] یا \f[CR]\-?\f[R]
پیام راهنما را نمایش می‌دهد و خارج می‌شود.
.TP
\f[CR]\-q\f[R]
فهرست تمام موتورهای اسکریپت موجود را نمایش می‌دهد و خارج می‌شود.
.SH "آرگومان‌ها (ARGUMENTS)"
اگر آرگومان‌هایی وجود داشته باشند و از هیچ‌یک از گزینه‌های \f[CR]\-e\f[R] یا \f[CR]\-f\f[R] استفاده نشده باشد، نخستین آرگومان به‌عنوان فایل اسکریپت و بقیهٔ آرگومان‌ها (در صورت وجود) به‌عنوان آرگومان‌های اسکریپت ارسال می‌شوند.
اگر آرگومان‌ها همراه با گزینهٔ \f[CR]\-e\f[R] یا \f[CR]\-f\f[R] به کار روند، تمامی آرگومان‌ها به‌عنوان آرگومان‌های اسکریپت ارسال خواهند شد.
اگر آرگومان‌ها و گزینه‌های \f[CR]\-e\f[R] و \f[CR]\-f\f[R] وارد نشوند، از حالت تعاملی استفاده می‌شود.
.SH "مثال اجرای اسکریپت‌های درون‌خطی (EXAMPLE OF EXECUTING INLINE SCRIPTS)"
.RS
.PP
\f[CR]jrunscript \-e \(dqprint(\(aqhello world\(aq)\(dq\f[R]
.RE
.RS
.PP
\f[CR]jrunscript \-e \(dqcat(\(aqhttp://www.example.com\(aq)\(dq\f[R]
.RE
.SH "مثال استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت (EXAMPLE OF USING SPECIFIED LANGUAGE AND EVALUATE THE SCRIPT FILE)"
.RS
.PP
\f[CR]jrunscript \-l js \-f test.js\f[R]
.RE
.SH "مثال حالت تعاملی (EXAMPLE OF INTERACTIVE MODE)"
.IP
.EX
jrunscript
js> print(\(aqHello World\(rsn\(aq);
Hello World
js> 34 + 55
89.0
js> t = new java.lang.Thread(function() { print(\(aqHello World\(rsn\(aq); })
Thread[Thread\-0,5,main]
js> t.start()
js> Hello World

js>
.EE
.SH "اجرای فایل اسکریپت با آرگومان‌های اسکریپت (RUN SCRIPT FILE WITH SCRIPT ARGUMENTS)"
در این مثال، فایل \f[CR]test.js\f[R] همان فایل اسکریپت است.
آرگومان‌های \f[CR]arg1\f[R]، \f[CR]arg2\f[R] و \f[CR]arg3\f[R] به اسکریپت ارسال می‌شوند.
اسکریپت می‌تواند از طریق آرایهٔ arguments به این آرگومان‌ها دسترسی داشته باشد.
.RS
.PP
\f[CR]jrunscript test.js arg1 arg2 arg3\f[R]
.RE