مرجع واجهة node:querystring

في الشيفرة الجديدة، فضّل ⁦URLSearchParams⁩. وتبقى ⁦node:querystring⁩ متاحة للتوافق مع الحزم الموجودة.

import querystring from "node:querystring";

const parsed = querystring.parse("name=Ada&role=engineer&role=manager");
console.log(parsed.role); // ["engineer", "manager"]

console.log(querystring.stringify({ name: "Ada", role: ["engineer", "manager"] }));
// name=Ada&role=engineer&role=manager

تصدّر الوحدة ⁦parse⁩ و⁦stringify⁩ و⁦escape⁩ و⁦unescape⁩ والاسمين البديلين ⁦decode⁩ و⁦encode⁩. والفواصل ومحددات الإسناد المخصّصة مدعومة.

يحوّل ⁦parse⁩ العلامة ⁦+⁩ إلى مسافات، ويجمع المفاتيح المكررة في مصفوفات، و يعيد كائنًا نموذجه الأولي ⁦null⁩. ولا يحوّل ⁦unescape⁩ العلامة ⁦+⁩. وتصبح قيم المصفوفات الممرَّرة إلى ⁦stringify⁩ أزواج مفتاح/قيمة متكررة.

راجع توثيق ⁦querystring⁩ في ⁦Node.js⁩ للخيارات القياسية وقواعد التحويل.

Reference

Status: Full · Not measured · since 1.1.0

Exports

Export	Kind	Status	Notes
`parse()`	function	Full	Parses a URL query string into a key-value object
`stringify()`	function	Full	Serializes an object into a URL query string
`escape()`	function	Full	Percent-encodes a string for use in a query string
`unescape()`	function	Full	Decodes a percent-encoded query string component
`encode()`	function	Full	Alias for stringify(); serializes an object into a query string
`decode()`	function	Full	Alias for parse(); parses a query string into a key-value object