مетод JSON.stringify() جاوااسکریپت
- صفحه قبلی parse()
- صفحه بعدی parse()
- بازگشت به لایه بالاتر دستورالعمل‌های مرجع JSON JavaScript
تعریف و استفاده
مетод JSON.stringify() یک شیء جاوااسکریپت را به رشته تبدیل می‌کند.
هنگام ارسال داده به سرور وب، داده باید یک رشته باشد.
مثال
مثال 1
سریال‌سازی شیء JavaScript:
var obj = { "name":"Bill", "age":19, "city":"Seattle"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;
مثال 2
استفاده از تابع جایگزین:
/* مقدار "city" را به حروف بزرگ تبدیل کنید: */
var obj = { "name":"Bill", "age":"19", "city":"Seattle"};
var text = JSON.stringify(obj, function (key, value) {
if (key == "city") {
return value.toUpperCase();
} else {
مقدار بازگشتی;
}
});
مثال 3
استفاده از space پارامتر:
/* برای هر فاصله، 10 فاصله قرار دهید: */
var obj = { "name":"Bill", "age":"19", "city":"Seattle"};
var text = JSON.stringify(obj, null, 10);
مثال 4
استفاده از space پارامتر:
/* برای هر فاصله، کلمه SPACE را وارد کنید: */
var obj = { "name":"Bill", "age":"19", "city":"Seattle"};
var text = JSON.stringify(obj, null, "SPACE");
قوانین دستور زبان
JSON.stringify(obj, replacer, space)
مقدار پارامتر
| پارامتر | توضیح |
|---|---|
| obj | ضروری. مقداری که باید به عنوان رشته تبدیل شود. |
| replacer |
اختیاری. یک تابع یا آرایه برای تبدیل نتایج. اگر این پارامتر یک تابع باشد، در طول فرآیند سریال‌سازی، هر ویژگی از مقدار سریال‌سازی شده توسط این تابع تبدیل و پردازش می‌شود؛ اگر این پارامتر یک آرایه باشد، تنها نام‌های ویژگی‌هایی که در این آرایه قرار دارند، به عنوان JSON سریال‌سازی می‌شوند؛ اگر این پارامتر null باشد یا ارائه نشده باشد، تمامی ویژگی‌های شیء به صورت JSON سریال‌سازی می‌شوند. |
| space |
اختیاری. یک رشته یا مقدار عددی. رشته‌ای که برای فاصله‌گذاری استفاده می‌شود، برای زیبا کردن خروجی (pretty-print) استفاده می‌شود. اگر این پارامتر یک عدد باشد، این عدد نشان‌دهنده تعداد فضاهایی است که باید بین عناصر قرار گیرند؛ حداکثر 10. اگر این مقدار کمتر از 1 باشد، به این معناست که هیچ فضایی وجود ندارد; اگر این پارامتر یک رشته باشد (وقتی که طول رشته بیش از 10 حرف باشد، 10 حرف اول را انتخاب می‌کند)، این رشته به عنوان فاصله در نظر گرفته می‌شود؛ اگر این پارامتر ارائه نشده باشد (یا null است)، هیچ فاصله‌ای وجود ندارد. |
جزئیات فنی
| مقدار بازگشتی: | یک رشته |
|---|---|
| نسخه JavaScript: | ECMAScript 5 |
پشتیبانی مرورگر
اعداد در جدول نشان‌دهنده نسخه اولین مرورگر هستند که از این روش کامل پشتیبانی می‌کند.
| روش | Chrome | IE | Firefox | Safari | Opera |
|---|---|---|---|---|---|
| stringify() | 4.0 | 8.0 | 3.5 | 4.0 | 11.5 |
صفحات مرتبط
آموزش JSON:مقدمه JSON
- صفحه قبلی parse()
- صفحه بعدی parse()
- بازگشت به لایه بالاتر دستورالعمل‌های مرجع JSON JavaScript
