Support :in_arrays option for Postgres::JSON{,B}#strip_nulls in pg_json_ops extension on PostgreSQL 18+

Author: jeremyevans

CHANGELOG

@@ -1,5 +1,7 @@
 === master
 
+* Support :in_arrays option for Postgres::JSON{,B}#strip_nulls in pg_json_ops extension on PostgreSQL 18+ (jeremyevans)
+
 * Support VIRTUAL generated columns on PostgreSQL 18+ using :virtual option (jeremyevans)
 
 === 5.95.1 (2025-08-05)

lib/sequel/extensions/pg_json_ops.rb

@@ -166,6 +166,11 @@
 #   #   "d" date EXISTS FALSE ON ERROR
 #   # ))
 #
+# On PostgreSQL 18+, strip_nulls can take an argument for whether to strip in arrays
+#
+#   j.strip_nulls(true)   # json_strip_nulls(json_column, true)
+#   j.strip_nulls(false)  # json_strip_nulls(json_column, false)
+#
 # If you are also using the pg_json extension, you should load it before
 # loading this extension.  Doing so will allow you to use the #op method on
 # JSONHash, JSONHarray, JSONBHash, and JSONBArray, allowing you to perform json/jsonb operations
@@ -380,11 +385,22 @@ def query(path, opts=OPTS)
         self.class.new(JSONQueryOp.new(self, path, opts))
       end
 
-      # Returns a json value stripped of all internal null values.
+      # Returns a json value stripped of all internal null values. Options:
+      #
+      # :in_arrays :: Whether to strip null values in JSON arrays
       #
-      #   json_op.strip_nulls # json_strip_nulls(json)
-      def strip_nulls
-        self.class.new(function(:strip_nulls))
+      #   json_op.strip_nulls                   # json_strip_nulls(json)
+      #   json_op.strip_nulls(in_arrays: true)  # json_strip_nulls(json, true)
+      #   json_op.strip_nulls(in_arrays: false) # json_strip_nulls(json, false)
+      def strip_nulls(opts=OPTS)
+        in_arrays = opts[:in_arrays]
+        f = if in_arrays.nil?
+          function(:strip_nulls)
+        else
+          function(:strip_nulls, in_arrays)
+        end
+
+        self.class.new(f)
       end
 
       # Returns json_table SQL function expression, querying JSON data and returning

spec/adapters/postgres_spec.rb

@@ -4863,6 +4863,11 @@ def left_item_id
       @db.from(j.table(Sequel['$.a.n'].as(:foo)){Integer :b}).all.must_equal [{:b=>3}]
       @db.from(j.table(Sequel['$.a'].as(:foo)){nested(Sequel['$.n'].as(:c)){Integer :b}}).all.must_equal [{:b=>3}]
     end if DB.server_version >= 170000
+
+    it '18+ jsonb strip_nulls in_arrays option with pg_json_ops' do
+      @db.get(pg_json.call([nil, 2, 3]).op.strip_nulls(in_arrays: false)[1]).must_equal 2
+      @db.get(pg_json.call([nil, 2, 3]).op.strip_nulls(in_arrays: true)[1]).must_equal 3
+    end if DB.server_version >= 180000
   end
 end if DB.server_version >= 90200
 

spec/extensions/pg_json_ops_spec.rb

@@ -204,6 +204,11 @@ def @db.server_version(*); 130000; end
     @l[@jb.strip_nulls].must_equal "jsonb_strip_nulls(j)"
   end
 
+  it "should have #strip_nulls respect the in_arrays option" do
+    @l[@j.strip_nulls(in_arrays: true)].must_equal "json_strip_nulls(j, true)"
+    @l[@jb.strip_nulls(in_arrays: false)].must_equal "jsonb_strip_nulls(j, false)"
+  end
+
   it "should have #typeof use the json_typeof function" do
     @l[@j.typeof].must_equal "json_typeof(j)"
     @l[@jb.typeof].must_equal "jsonb_typeof(j)"