From 5b43f2e36f7ed81a7c3f8266a5f3db29e7722884 Mon Sep 17 00:00:00 2001
From: James Addison <jay@jp-hosting.net>
Date: Tue, 5 May 2020 13:02:01 +0100
Subject: [PATCH] jQuery.param: Document standaloneKeys argument

---
 entries/jQuery.param.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/entries/jQuery.param.xml b/entries/jQuery.param.xml
index 9a80fc2b..bcec5563 100644
--- a/entries/jQuery.param.xml
+++ b/entries/jQuery.param.xml
@@ -21,6 +21,9 @@
     <argument name="traditional" type="Boolean">
       <desc>A Boolean indicating whether to perform a traditional "shallow" serialization.</desc>
     </argument>
+    <argument name="standaloneKeys" type="Boolean">
+      <desc>A Boolean indicating whether to use abbreviated serialization of keys with null values</desc>
+    </argument>
   </signature>
   <desc>Create a serialized representation of an array, a plain object, or a jQuery object suitable for use in a URL query string or Ajax request. In case a jQuery object is passed, it should contain input elements with name/value properties.</desc>
   <longdesc>
@@ -87,6 +90,16 @@ alert( shallowDecoded );
       <br/>
       <samp>a=[object+Object]&amp;b=1&amp;b=2&amp;b=3</samp>
     </p>
+    <p>To abbreviate the serialization of keys with null values, we can set the <code>standaloneKeys</code> argument to <code>true</code></p>
+    <pre><code>
+var myObject = {
+  x: 1,
+  y: null
+};
+var abbreviatedSerialization = $.param( myObject, false, true );
+
+alert( abbreviatedSerialization );
+    </code></pre>
   </longdesc>
   <example>
     <desc>Serialize a key/value object.</desc>