Document new params argument to s3.putObject

Author: oleiade

src/data/markdown/docs/20 jslib/01 jslib/01 aws/S3Client/00 putObject(bucketName, objectKey, data).md

@@ -8,11 +8,22 @@ excerpt: 'S3Client.putObject uploads an object to a bucket'
 
 ### Parameters
 
-| Parameter  | Type                  | Description                                  |
-| :--------- | :-------------------- | :------------------------------------------- |
-| bucketName | string                | Name of the bucket to upload the object to.  |
-| objectKey  | string                | Name of the uploaded object.                 |
-| data       | string \| ArrayBuffer | Content of the object to upload.             |
+| Parameter     | Type                                            | Description                                  |
+| :------------ | :---------------------------------------------- | :------------------------------------------- |
+| `bucketName`  | string                                          | Name of the bucket to upload the object to.  |
+| `objectKey`   | string                                          | Name of the uploaded object.                 |
+| `data`        | string \| ArrayBuffer                           | Content of the object to upload.             |
+| `params`      | [PutObjectParams](#putobjectparams) (optional)  | Options for the request. |
+
+#### PutObjectParams
+
+| Name                  | Type              | Description |
+| :-------------------- | :---------------- | :---------- |
+| `contentDisposition`  | string (optional) | Specifies presentational information for the object. For more information, see [RFC 6266](https://tools.ietf.org/html/rfc6266). |
+| `contentEncoding`     | string (optional) | Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. For more information, see [RFC 2616](https://tools.ietf.org/html/rfc2616). |
+| `contentLength`       | number (optional) | Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically. |
+| `contentMD5`          | string (optional) | The base64-encoded 128-bit MD5 digest of the message (without the headers) according to RFC 1864. This header can be used as a message integrity check to verify that the received message is identical to the message that was sent. |
+| `contentType`         | string (optional) | A standard MIME type describing the format of the object data. For more information, see [RFC 2616](https://tools.ietf.org/html/rfc2616). |
 
 ### Returns
 
@@ -40,7 +51,10 @@ const testFile = open('./bonjour.txt', 'r');
 
 export default async function () {
   // Let's upload our test file to the bucket
-  await s3.putObject(testBucketName, testFileKey, testFile);
+  await s3.putObject(testBucketName, testFileKey, testFile, {
+    contentType: 'text/plain',
+    contentLength: testFile.length,
+  });
 
   // And let's redownload it to verify it's correct
   const obj = await s3.getObject(testBucketName, testFileKey);