Enhance req.acceptsEncodings

lib/request.js

@@ -134,16 +134,37 @@ req.accepts = function(){
 };
 
 /**
- * Check if the given `encoding`s are accepted.
+ * Checks if the specified encodings are accepted based on the request's `Accept-Encoding` header.
+ * Returns the best matching encoding or an array of acceptable encodings.
  *
- * @param {String} ...encoding
- * @return {String|Array}
+ * The `encoding` argument(s) can be:
+ * - A single encoding string (e.g., "gzip")
+ * - Multiple encoding strings as arguments (e.g., `"gzip", "deflate"`)
+ * - A comma-delimited list of encodings (e.g., `"gzip, deflate"`)
+ *
+ * Examples:
+ *
+ *     // Accept-Encoding: gzip, deflate
+ *     req.acceptsEncodings('gzip');
+ *     // => "gzip"
+ *
+ *     req.acceptsEncodings('gzip', 'deflate');
+ *     // => "gzip"
+ *
+ *     req.acceptsEncodings('br');
+ *     // => false
+ *
+ *     req.acceptsEncodings('gzip, br');
+ *     // => "gzip"
+ *
+ * @param {...String} encodings - The encoding(s) to check against the `Accept-Encoding` header.
+ * @return {String|Array} - The best matching encoding, or an array of acceptable encodings.
  * @public
  */
 
-req.acceptsEncodings = function(){
-  var accept = accepts(this);
-  return accept.encodings.apply(accept, arguments);
+req.acceptsEncodings = function(...encodings) {
+  const accept = accepts(this);
+  return accept.encodings(...encodings);
 };
 
 /**

test/req.acceptsEncodings.js

@@ -17,7 +17,7 @@ describe('req', function(){
 
       request(app)
         .get('/')
-        .set('Accept-Encoding', ' gzip, deflate')
+        .set('Accept-Encoding', 'gzip, deflate')
         .expect(200, { gzip: 'gzip', deflate: 'deflate' }, done)
     })
 
@@ -32,8 +32,38 @@ describe('req', function(){
 
       request(app)
         .get('/')
-        .set('Accept-Encoding', ' gzip, deflate')
+        .set('Accept-Encoding', 'gzip, deflate')
         .expect(200, { bogus: false }, done)
     })
+
+    it('should return the best matching encoding from multiple options', function(done) {
+      var app = express();
+
+      app.get('/', function (req, res) {
+        res.send({
+          best: req.acceptsEncodings('br', 'gzip', 'deflate')
+        })
+      })
+
+      request(app)
+        .get('/')
+        .set('Accept-Encoding', 'gzip, deflate')
+        .expect(200, { best: 'gzip' }, done)
+    });
+
+    it('should handle multiple encodings correctly', function(done) {
+      var app = express();
+
+      app.get('/', function (req, res) {
+        res.send({
+          result: req.acceptsEncodings('gzip', 'deflate', 'br')
+        })
+      })
+
+      request(app)
+        .get('/')
+        .set('Accept-Encoding', 'gzip, deflate, br')
+        .expect(200, { result: 'gzip' }, done)
+    });
   })
 })