@aws-sdk/client-synthetics 3.873.0 → 3.874.0

package/dist-cjs/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   AccessDeniedException: () => AccessDeniedException,
   AssociateResourceCommand: () => AssociateResourceCommand,
   BadRequestException: () => BadRequestException,
+  BrowserType: () => BrowserType,
   CanaryRunState: () => CanaryRunState,
   CanaryRunStateReasonCode: () => CanaryRunStateReasonCode,
   CanaryRunTestResult: () => CanaryRunTestResult,
@@ -392,6 +393,10 @@ var BadRequestException = class _BadRequestException extends SyntheticsServiceEx
     this.Message = opts.Message;
   }
 };
+var BrowserType = {
+  CHROME: "CHROME",
+  FIREFOX: "FIREFOX"
+};
 var DependencyType = {
   LambdaLayer: "LambdaLayer"
 };
@@ -554,6 +559,7 @@ var se_CreateCanaryCommand = /* @__PURE__ */ __name(async (input, context) => {
     (0, import_smithy_client.take)(input, {
       ArtifactConfig: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "ArtifactConfig"),
       ArtifactS3Location: [],
+      BrowserConfigs: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "BrowserConfigs"),
       Code: /* @__PURE__ */ __name((_) => se_CanaryCodeInput(_, context), "Code"),
       ExecutionRoleArn: [],
       FailureRetentionPeriodInDays: [],
@@ -634,6 +640,7 @@ var se_DescribeCanariesLastRunCommand = /* @__PURE__ */ __name(async (input, con
   let body;
   body = JSON.stringify(
     (0, import_smithy_client.take)(input, {
+      BrowserType: [],
       MaxResults: [],
       Names: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "Names"),
       NextToken: []
@@ -794,6 +801,7 @@ var se_StartCanaryDryRunCommand = /* @__PURE__ */ __name(async (input, context)
     (0, import_smithy_client.take)(input, {
       ArtifactConfig: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "ArtifactConfig"),
       ArtifactS3Location: [],
+      BrowserConfigs: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "BrowserConfigs"),
       Code: /* @__PURE__ */ __name((_) => se_CanaryCodeInput(_, context), "Code"),
       ExecutionRoleArn: [],
       FailureRetentionPeriodInDays: [],
@@ -802,6 +810,7 @@ var se_StartCanaryDryRunCommand = /* @__PURE__ */ __name(async (input, context)
       RuntimeVersion: [],
       SuccessRetentionPeriodInDays: [],
       VisualReference: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "VisualReference"),
+      VisualReferences: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "VisualReferences"),
       VpcConfig: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "VpcConfig")
     })
   );
@@ -857,6 +866,7 @@ var se_UpdateCanaryCommand = /* @__PURE__ */ __name(async (input, context) => {
     (0, import_smithy_client.take)(input, {
       ArtifactConfig: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "ArtifactConfig"),
       ArtifactS3Location: [],
+      BrowserConfigs: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "BrowserConfigs"),
       Code: /* @__PURE__ */ __name((_) => se_CanaryCodeInput(_, context), "Code"),
       DryRunId: [],
       ExecutionRoleArn: [],
@@ -867,6 +877,7 @@ var se_UpdateCanaryCommand = /* @__PURE__ */ __name(async (input, context) => {
       Schedule: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "Schedule"),
       SuccessRetentionPeriodInDays: [],
       VisualReference: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "VisualReference"),
+      VisualReferences: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "VisualReferences"),
       VpcConfig: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "VpcConfig")
     })
   );
@@ -1371,9 +1382,11 @@ var de_Canary = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
     ArtifactConfig: import_smithy_client._json,
     ArtifactS3Location: import_smithy_client.expectString,
+    BrowserConfigs: import_smithy_client._json,
     Code: import_smithy_client._json,
     DryRunConfig: import_smithy_client._json,
     EngineArn: import_smithy_client.expectString,
+    EngineConfigs: import_smithy_client._json,
     ExecutionRoleArn: import_smithy_client.expectString,
     FailureRetentionPeriodInDays: import_smithy_client.expectInt32,
     Id: import_smithy_client.expectString,
@@ -1387,6 +1400,7 @@ var de_Canary = /* @__PURE__ */ __name((output, context) => {
     Tags: import_smithy_client._json,
     Timeline: /* @__PURE__ */ __name((_) => de_CanaryTimeline(_, context), "Timeline"),
     VisualReference: import_smithy_client._json,
+    VisualReferences: import_smithy_client._json,
     VpcConfig: import_smithy_client._json
   });
 }, "de_Canary");
@@ -1399,6 +1413,7 @@ var de_CanaryLastRun = /* @__PURE__ */ __name((output, context) => {
 var de_CanaryRun = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
     ArtifactS3Location: import_smithy_client.expectString,
+    BrowserType: import_smithy_client.expectString,
     DryRunConfig: import_smithy_client._json,
     Id: import_smithy_client.expectString,
     Name: import_smithy_client.expectString,
@@ -1897,6 +1912,7 @@ var paginateListGroups = (0, import_core.createPaginator)(SyntheticsClient, List
   ServiceQuotaExceededException,
   ValidationException,
   BadRequestException,
+  BrowserType,
   DependencyType,
   ProvisionedResourceCleanupSetting,
   CanaryState,

package/dist-es/models/models_0.js

@@ -101,6 +101,10 @@ export class BadRequestException extends __BaseException {
         this.Message = opts.Message;
     }
 }
+export const BrowserType = {
+    CHROME: "CHROME",
+    FIREFOX: "FIREFOX",
+};
 export const DependencyType = {
     LambdaLayer: "LambdaLayer",
 };

package/dist-es/protocols/Aws_restJson1.js

@@ -27,6 +27,7 @@ export const se_CreateCanaryCommand = async (input, context) => {
     body = JSON.stringify(take(input, {
         ArtifactConfig: (_) => _json(_),
         ArtifactS3Location: [],
+        BrowserConfigs: (_) => _json(_),
         Code: (_) => se_CanaryCodeInput(_, context),
         ExecutionRoleArn: [],
         FailureRetentionPeriodInDays: [],
@@ -101,6 +102,7 @@ export const se_DescribeCanariesLastRunCommand = async (input, context) => {
     b.bp("/canaries/last-run");
     let body;
     body = JSON.stringify(take(input, {
+        BrowserType: [],
         MaxResults: [],
         Names: (_) => _json(_),
         NextToken: [],
@@ -247,6 +249,7 @@ export const se_StartCanaryDryRunCommand = async (input, context) => {
     body = JSON.stringify(take(input, {
         ArtifactConfig: (_) => _json(_),
         ArtifactS3Location: [],
+        BrowserConfigs: (_) => _json(_),
         Code: (_) => se_CanaryCodeInput(_, context),
         ExecutionRoleArn: [],
         FailureRetentionPeriodInDays: [],
@@ -255,6 +258,7 @@ export const se_StartCanaryDryRunCommand = async (input, context) => {
         RuntimeVersion: [],
         SuccessRetentionPeriodInDays: [],
         VisualReference: (_) => _json(_),
+        VisualReferences: (_) => _json(_),
         VpcConfig: (_) => _json(_),
     }));
     b.m("POST").h(headers).b(body);
@@ -306,6 +310,7 @@ export const se_UpdateCanaryCommand = async (input, context) => {
     body = JSON.stringify(take(input, {
         ArtifactConfig: (_) => _json(_),
         ArtifactS3Location: [],
+        BrowserConfigs: (_) => _json(_),
         Code: (_) => se_CanaryCodeInput(_, context),
         DryRunId: [],
         ExecutionRoleArn: [],
@@ -316,6 +321,7 @@ export const se_UpdateCanaryCommand = async (input, context) => {
         Schedule: (_) => _json(_),
         SuccessRetentionPeriodInDays: [],
         VisualReference: (_) => _json(_),
+        VisualReferences: (_) => _json(_),
         VpcConfig: (_) => _json(_),
     }));
     b.m("PATCH").h(headers).b(body);
@@ -823,9 +829,11 @@ const de_Canary = (output, context) => {
     return take(output, {
         ArtifactConfig: _json,
         ArtifactS3Location: __expectString,
+        BrowserConfigs: _json,
         Code: _json,
         DryRunConfig: _json,
         EngineArn: __expectString,
+        EngineConfigs: _json,
         ExecutionRoleArn: __expectString,
         FailureRetentionPeriodInDays: __expectInt32,
         Id: __expectString,
@@ -839,6 +847,7 @@ const de_Canary = (output, context) => {
         Tags: _json,
         Timeline: (_) => de_CanaryTimeline(_, context),
         VisualReference: _json,
+        VisualReferences: _json,
         VpcConfig: _json,
     });
 };
@@ -851,6 +860,7 @@ const de_CanaryLastRun = (output, context) => {
 const de_CanaryRun = (output, context) => {
     return take(output, {
         ArtifactS3Location: __expectString,
+        BrowserType: __expectString,
         DryRunConfig: _json,
         Id: __expectString,
         Name: __expectString,

package/dist-types/commands/CreateCanaryCommand.d.ts

@@ -96,6 +96,11 @@ declare const CreateCanaryCommand_base: {
  *     "lambda-function",
  *   ],
  *   ProvisionedResourceCleanup: "AUTOMATIC" || "OFF",
+ *   BrowserConfigs: [ // BrowserConfigs
+ *     { // BrowserConfig
+ *       BrowserType: "CHROME" || "FIREFOX",
+ *     },
+ *   ],
  *   Tags: { // TagMap
  *     "<keys>": "STRING_VALUE",
  *   },
@@ -172,8 +177,34 @@ declare const CreateCanaryCommand_base: {
  * //         },
  * //       ],
  * //       BaseCanaryRunId: "STRING_VALUE",
+ * //       BrowserType: "CHROME" || "FIREFOX",
  * //     },
  * //     ProvisionedResourceCleanup: "AUTOMATIC" || "OFF",
+ * //     BrowserConfigs: [ // BrowserConfigs
+ * //       { // BrowserConfig
+ * //         BrowserType: "CHROME" || "FIREFOX",
+ * //       },
+ * //     ],
+ * //     EngineConfigs: [ // EngineConfigs
+ * //       { // EngineConfig
+ * //         EngineArn: "STRING_VALUE",
+ * //         BrowserType: "CHROME" || "FIREFOX",
+ * //       },
+ * //     ],
+ * //     VisualReferences: [ // VisualReferencesOutput
+ * //       {
+ * //         BaseScreenshots: [
+ * //           {
+ * //             ScreenshotName: "STRING_VALUE", // required
+ * //             IgnoreCoordinates: [
+ * //               "STRING_VALUE",
+ * //             ],
+ * //           },
+ * //         ],
+ * //         BaseCanaryRunId: "STRING_VALUE",
+ * //         BrowserType: "CHROME" || "FIREFOX",
+ * //       },
+ * //     ],
  * //     Tags: { // TagMap
  * //       "<keys>": "STRING_VALUE",
  * //     },

package/dist-types/commands/DescribeCanariesCommand.d.ts

@@ -117,8 +117,34 @@ declare const DescribeCanariesCommand_base: {
  * //           },
  * //         ],
  * //         BaseCanaryRunId: "STRING_VALUE",
+ * //         BrowserType: "CHROME" || "FIREFOX",
  * //       },
  * //       ProvisionedResourceCleanup: "AUTOMATIC" || "OFF",
+ * //       BrowserConfigs: [ // BrowserConfigs
+ * //         { // BrowserConfig
+ * //           BrowserType: "CHROME" || "FIREFOX",
+ * //         },
+ * //       ],
+ * //       EngineConfigs: [ // EngineConfigs
+ * //         { // EngineConfig
+ * //           EngineArn: "STRING_VALUE",
+ * //           BrowserType: "CHROME" || "FIREFOX",
+ * //         },
+ * //       ],
+ * //       VisualReferences: [ // VisualReferencesOutput
+ * //         {
+ * //           BaseScreenshots: [
+ * //             {
+ * //               ScreenshotName: "STRING_VALUE", // required
+ * //               IgnoreCoordinates: [
+ * //                 "STRING_VALUE",
+ * //               ],
+ * //             },
+ * //           ],
+ * //           BaseCanaryRunId: "STRING_VALUE",
+ * //           BrowserType: "CHROME" || "FIREFOX",
+ * //         },
+ * //       ],
  * //       Tags: { // TagMap
  * //         "<keys>": "STRING_VALUE",
  * //       },

package/dist-types/commands/DescribeCanariesLastRunCommand.d.ts

@@ -48,6 +48,7 @@ declare const DescribeCanariesLastRunCommand_base: {
  *   Names: [ // DescribeCanariesLastRunNameFilter
  *     "STRING_VALUE",
  *   ],
+ *   BrowserType: "CHROME" || "FIREFOX",
  * };
  * const command = new DescribeCanariesLastRunCommand(input);
  * const response = await client.send(command);
@@ -75,6 +76,7 @@ declare const DescribeCanariesLastRunCommand_base: {
  * //         DryRunConfig: { // CanaryDryRunConfigOutput
  * //           DryRunId: "STRING_VALUE",
  * //         },
+ * //         BrowserType: "CHROME" || "FIREFOX",
  * //       },
  * //     },
  * //   ],

package/dist-types/commands/GetCanaryCommand.d.ts

@@ -106,8 +106,34 @@ declare const GetCanaryCommand_base: {
  * //         },
  * //       ],
  * //       BaseCanaryRunId: "STRING_VALUE",
+ * //       BrowserType: "CHROME" || "FIREFOX",
  * //     },
  * //     ProvisionedResourceCleanup: "AUTOMATIC" || "OFF",
+ * //     BrowserConfigs: [ // BrowserConfigs
+ * //       { // BrowserConfig
+ * //         BrowserType: "CHROME" || "FIREFOX",
+ * //       },
+ * //     ],
+ * //     EngineConfigs: [ // EngineConfigs
+ * //       { // EngineConfig
+ * //         EngineArn: "STRING_VALUE",
+ * //         BrowserType: "CHROME" || "FIREFOX",
+ * //       },
+ * //     ],
+ * //     VisualReferences: [ // VisualReferencesOutput
+ * //       {
+ * //         BaseScreenshots: [
+ * //           {
+ * //             ScreenshotName: "STRING_VALUE", // required
+ * //             IgnoreCoordinates: [
+ * //               "STRING_VALUE",
+ * //             ],
+ * //           },
+ * //         ],
+ * //         BaseCanaryRunId: "STRING_VALUE",
+ * //         BrowserType: "CHROME" || "FIREFOX",
+ * //       },
+ * //     ],
  * //     Tags: { // TagMap
  * //       "<keys>": "STRING_VALUE",
  * //     },

package/dist-types/commands/GetCanaryRunsCommand.d.ts

@@ -65,6 +65,7 @@ declare const GetCanaryRunsCommand_base: {
  * //       DryRunConfig: { // CanaryDryRunConfigOutput
  * //         DryRunId: "STRING_VALUE",
  * //       },
+ * //       BrowserType: "CHROME" || "FIREFOX",
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",

package/dist-types/commands/StartCanaryDryRunCommand.d.ts

@@ -81,6 +81,7 @@ declare const StartCanaryDryRunCommand_base: {
  *       },
  *     ],
  *     BaseCanaryRunId: "STRING_VALUE", // required
+ *     BrowserType: "CHROME" || "FIREFOX",
  *   },
  *   ArtifactS3Location: "STRING_VALUE",
  *   ArtifactConfig: { // ArtifactConfigInput
@@ -90,6 +91,25 @@ declare const StartCanaryDryRunCommand_base: {
  *     },
  *   },
  *   ProvisionedResourceCleanup: "AUTOMATIC" || "OFF",
+ *   BrowserConfigs: [ // BrowserConfigs
+ *     { // BrowserConfig
+ *       BrowserType: "CHROME" || "FIREFOX",
+ *     },
+ *   ],
+ *   VisualReferences: [ // VisualReferences
+ *     {
+ *       BaseScreenshots: [
+ *         {
+ *           ScreenshotName: "STRING_VALUE", // required
+ *           IgnoreCoordinates: [
+ *             "STRING_VALUE",
+ *           ],
+ *         },
+ *       ],
+ *       BaseCanaryRunId: "STRING_VALUE", // required
+ *       BrowserType: "CHROME" || "FIREFOX",
+ *     },
+ *   ],
  * };
  * const command = new StartCanaryDryRunCommand(input);
  * const response = await client.send(command);

package/dist-types/commands/UpdateCanaryCommand.d.ts

@@ -27,10 +27,17 @@ declare const UpdateCanaryCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Updates the configuration of a canary that has
- *          already been created.</p>
- *          <p>You can't use this operation to update the tags of an existing canary. To
- *          change the tags of an existing canary, use
+ * <p>Updates the configuration of a canary that has already been created.</p>
+ *          <p>For multibrowser canaries, you can add or remove browsers by updating the browserConfig list in the update call. For example:</p>
+ *          <ul>
+ *             <li>
+ *                <p>To add Firefox to a canary that currently uses Chrome, specify browserConfigs as [CHROME, FIREFOX]</p>
+ *             </li>
+ *             <li>
+ *                <p>To remove Firefox and keep only Chrome, specify browserConfigs as [CHROME]</p>
+ *             </li>
+ *          </ul>
+ *          <p>You can't use this operation to update the tags of an existing canary. To change the tags of an existing canary, use
  *          <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_TagResource.html">TagResource</a>.</p>
  *          <note>
  *             <p>When you use the <code>dryRunId</code> field when updating a canary, the only other field you can provide is the <code>Schedule</code>. Adding any other field will thrown an exception.</p>
@@ -95,6 +102,7 @@ declare const UpdateCanaryCommand_base: {
  *       },
  *     ],
  *     BaseCanaryRunId: "STRING_VALUE", // required
+ *     BrowserType: "CHROME" || "FIREFOX",
  *   },
  *   ArtifactS3Location: "STRING_VALUE",
  *   ArtifactConfig: { // ArtifactConfigInput
@@ -105,6 +113,25 @@ declare const UpdateCanaryCommand_base: {
  *   },
  *   ProvisionedResourceCleanup: "AUTOMATIC" || "OFF",
  *   DryRunId: "STRING_VALUE",
+ *   VisualReferences: [ // VisualReferences
+ *     {
+ *       BaseScreenshots: [
+ *         {
+ *           ScreenshotName: "STRING_VALUE", // required
+ *           IgnoreCoordinates: [
+ *             "STRING_VALUE",
+ *           ],
+ *         },
+ *       ],
+ *       BaseCanaryRunId: "STRING_VALUE", // required
+ *       BrowserType: "CHROME" || "FIREFOX",
+ *     },
+ *   ],
+ *   BrowserConfigs: [ // BrowserConfigs
+ *     { // BrowserConfig
+ *       BrowserType: "CHROME" || "FIREFOX",
+ *     },
+ *   ],
  * };
  * const command = new UpdateCanaryCommand(input);
  * const response = await client.send(command);

package/dist-types/models/models_0.d.ts

@@ -202,6 +202,29 @@ export interface BaseScreenshot {
      */
     IgnoreCoordinates?: string[] | undefined;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const BrowserType: {
+    readonly CHROME: "CHROME";
+    readonly FIREFOX: "FIREFOX";
+};
+/**
+ * @public
+ */
+export type BrowserType = (typeof BrowserType)[keyof typeof BrowserType];
+/**
+ * <p>A structure that specifies the browser type to use for a canary run.</p>
+ * @public
+ */
+export interface BrowserConfig {
+    /**
+     * <p>The browser type associated with this browser configuration.</p>
+     * @public
+     */
+    BrowserType?: BrowserType | undefined;
+}
 /**
  * @public
  * @enum
@@ -268,6 +291,23 @@ export interface DryRunConfigOutput {
      */
     LastDryRunExecutionStatus?: string | undefined;
 }
+/**
+ * <p>A structure of engine configurations for the canary, one for each browser type that the canary is configured to run on.</p>
+ * @public
+ */
+export interface EngineConfig {
+    /**
+     * <p>Each engine configuration contains the ARN of the Lambda function that is used as the canary's engine for a specific browser type.
+     *          </p>
+     * @public
+     */
+    EngineArn?: string | undefined;
+    /**
+     * <p>The browser type associated with this engine configuration.</p>
+     * @public
+     */
+    BrowserType?: BrowserType | undefined;
+}
 /**
  * @public
  * @enum
@@ -461,6 +501,11 @@ export interface VisualReferenceOutput {
      * @public
      */
     BaseCanaryRunId?: string | undefined;
+    /**
+     * <p>The browser type associated with this visual reference.</p>
+     * @public
+     */
+    BrowserType?: BrowserType | undefined;
 }
 /**
  * <p>If this canary is to test an endpoint in a VPC, this structure contains
@@ -599,6 +644,31 @@ export interface Canary {
      * @public
      */
     ProvisionedResourceCleanup?: ProvisionedResourceCleanupSetting | undefined;
+    /**
+     * <p>A structure that specifies the browser type to use for a canary run. CloudWatch Synthetics supports running canaries on both <code>CHROME</code> and <code>FIREFOX</code> browsers.</p>
+     *          <note>
+     *             <p>If not specified, <code>browserConfigs</code> defaults to Chrome.</p>
+     *          </note>
+     * @public
+     */
+    BrowserConfigs?: BrowserConfig[] | undefined;
+    /**
+     * <p>A list of engine configurations for the canary, one for each browser type that the canary is configured to run on.</p>
+     *          <p>All runtime versions <code>syn-nodejs-puppeteer-11.0</code> and above, and <code>syn-nodejs-playwright-3.0</code> and above, use <code>engineConfigs</code> only.
+     *          You can no longer use <code>engineArn</code> in these versions.</p>
+     *          <p>Runtime versions older than <code>syn-nodejs-puppeteer-11.0</code> and <code>syn-nodejs-playwright-3.0</code> continue to support <code>engineArn</code> to ensure backward compatibility.</p>
+     * @public
+     */
+    EngineConfigs?: EngineConfig[] | undefined;
+    /**
+     * <p>A list of visual reference configurations for the canary, one for each browser type that the canary is configured to run on. Visual references are used for visual monitoring comparisons.</p>
+     *          <p>
+     *             <code>syn-nodejs-puppeteer-11.0</code> and above, and <code>syn-nodejs-playwright-3.0</code> and above, only supports <code>visualReferences</code>. <code>visualReference</code> field is not supported.</p>
+     *          <p>Versions older than <code>syn-nodejs-puppeteer-11.0</code> supports both <code>visualReference</code> and <code>visualReferences</code> for backward compatibility. It is recommended to use <code>visualReferences</code>
+     *          for consistency and future compatibility.</p>
+     * @public
+     */
+    VisualReferences?: VisualReferenceOutput[] | undefined;
     /**
      * <p>The list of key-value pairs that are associated with the canary.</p>
      * @public
@@ -762,6 +832,11 @@ export interface CanaryRun {
      * @public
      */
     DryRunConfig?: CanaryDryRunConfigOutput | undefined;
+    /**
+     * <p>The browser type associated with this canary run.</p>
+     * @public
+     */
+    BrowserType?: BrowserType | undefined;
 }
 /**
  * <p>This structure contains information about the most recent run of a single canary.</p>
@@ -1139,6 +1214,15 @@ export interface CreateCanaryRequest {
      * @public
      */
     ProvisionedResourceCleanup?: ProvisionedResourceCleanupSetting | undefined;
+    /**
+     * <p>CloudWatch Synthetics now supports multibrowser canaries for <code>syn-nodejs-puppeteer-11.0</code> and <code>syn-nodejs-playwright-3.0</code> runtimes. This feature allows you to run your canaries on both
+     *          Firefox and Chrome browsers. To create a multibrowser canary, you need to specify the BrowserConfigs with a list of browsers you want to use.</p>
+     *          <note>
+     *             <p>If not specified, <code>browserConfigs</code> defaults to Chrome.</p>
+     *          </note>
+     * @public
+     */
+    BrowserConfigs?: BrowserConfig[] | undefined;
     /**
      * <p>A list of key-value pairs to associate with the canary.
      *          You can associate as many as 50 tags with a canary.</p>
@@ -1368,6 +1452,11 @@ export interface DescribeCanariesLastRunRequest {
      * @public
      */
     Names?: string[] | undefined;
+    /**
+     * <p>The type of browser to use for the canary run.</p>
+     * @public
+     */
+    BrowserType?: BrowserType | undefined;
 }
 /**
  * @public
@@ -1849,6 +1938,11 @@ export interface VisualReferenceInput {
      * @public
      */
     BaseCanaryRunId: string | undefined;
+    /**
+     * <p>The browser type associated with this visual reference.</p>
+     * @public
+     */
+    BrowserType?: BrowserType | undefined;
 }
 /**
  * @public
@@ -1968,6 +2062,23 @@ export interface StartCanaryDryRunRequest {
      * @public
      */
     ProvisionedResourceCleanup?: ProvisionedResourceCleanupSetting | undefined;
+    /**
+     * <p>A structure that specifies the browser type to use for a canary run. CloudWatch Synthetics supports running canaries on both <code>CHROME</code> and <code>FIREFOX</code> browsers.</p>
+     *          <note>
+     *             <p>If not specified, <code>browserConfigs</code> defaults to Chrome.</p>
+     *          </note>
+     * @public
+     */
+    BrowserConfigs?: BrowserConfig[] | undefined;
+    /**
+     * <p>A list of visual reference configurations for the canary, one for each browser type that the canary is configured to run on. Visual references are used for visual monitoring comparisons.</p>
+     *          <p>
+     *             <code>syn-nodejs-puppeteer-11.0</code> and above, and <code>syn-nodejs-playwright-3.0</code> and above, only supports <code>visualReferences</code>. <code>visualReference</code> field is not supported.</p>
+     *          <p>Versions older than <code>syn-nodejs-puppeteer-11.0</code> supports both <code>visualReference</code> and <code>visualReferences</code> for backward compatibility. It is recommended to use <code>visualReferences</code>
+     *          for consistency and future compatibility.</p>
+     * @public
+     */
+    VisualReferences?: VisualReferenceInput[] | undefined;
 }
 /**
  * @public
@@ -2203,6 +2314,27 @@ export interface UpdateCanaryRequest {
      * @public
      */
     DryRunId?: string | undefined;
+    /**
+     * <p>A list of visual reference configurations for the canary, one for each browser type that the canary is configured to run on. Visual references are used for visual monitoring comparisons.</p>
+     *          <p>
+     *             <code>syn-nodejs-puppeteer-11.0</code> and above, and <code>syn-nodejs-playwright-3.0</code> and above, only supports <code>visualReferences</code>. <code>visualReference</code> field is not supported.</p>
+     *          <p>Versions older than <code>syn-nodejs-puppeteer-11.0</code> supports both <code>visualReference</code> and <code>visualReferences</code> for backward compatibility. It is recommended to use <code>visualReferences</code>
+     *          for consistency and future compatibility.</p>
+     *          <p>For multibrowser visual monitoring,  you can update the baseline for all configured browsers in a single update call by specifying a list of VisualReference objects, one per browser.
+     *          Each VisualReference object maps to a specific browser configuration, allowing you to manage visual baselines for multiple browsers simultaneously.</p>
+     *          <p>For single configuration canaries using Chrome browser (default browser), use visualReferences for <code>syn-nodejs-puppeteer-11.0</code> and above, and <code>syn-nodejs-playwright-3.0</code> and
+     *          above canaries. The browserType in the visualReference object is not mandatory.</p>
+     * @public
+     */
+    VisualReferences?: VisualReferenceInput[] | undefined;
+    /**
+     * <p>A structure that specifies the browser type to use for a canary run. CloudWatch Synthetics supports running canaries on both <code>CHROME</code> and <code>FIREFOX</code> browsers.</p>
+     *          <note>
+     *             <p>If not specified, <code>browserConfigs</code> defaults to Chrome.</p>
+     *          </note>
+     * @public
+     */
+    BrowserConfigs?: BrowserConfig[] | undefined;
 }
 /**
  * @public

package/dist-types/ts3.4/models/models_0.d.ts

@@ -79,6 +79,14 @@ export interface BaseScreenshot {
   ScreenshotName: string | undefined;
   IgnoreCoordinates?: string[] | undefined;
 }
+export declare const BrowserType: {
+  readonly CHROME: "CHROME";
+  readonly FIREFOX: "FIREFOX";
+};
+export type BrowserType = (typeof BrowserType)[keyof typeof BrowserType];
+export interface BrowserConfig {
+  BrowserType?: BrowserType | undefined;
+}
 export declare const DependencyType: {
   readonly LambdaLayer: "LambdaLayer";
 };
@@ -97,6 +105,10 @@ export interface DryRunConfigOutput {
   DryRunId?: string | undefined;
   LastDryRunExecutionStatus?: string | undefined;
 }
+export interface EngineConfig {
+  EngineArn?: string | undefined;
+  BrowserType?: BrowserType | undefined;
+}
 export declare const ProvisionedResourceCleanupSetting: {
   readonly AUTOMATIC: "AUTOMATIC";
   readonly OFF: "OFF";
@@ -159,6 +171,7 @@ export interface CanaryTimeline {
 export interface VisualReferenceOutput {
   BaseScreenshots?: BaseScreenshot[] | undefined;
   BaseCanaryRunId?: string | undefined;
+  BrowserType?: BrowserType | undefined;
 }
 export interface VpcConfigOutput {
   VpcId?: string | undefined;
@@ -183,6 +196,9 @@ export interface Canary {
   VpcConfig?: VpcConfigOutput | undefined;
   VisualReference?: VisualReferenceOutput | undefined;
   ProvisionedResourceCleanup?: ProvisionedResourceCleanupSetting | undefined;
+  BrowserConfigs?: BrowserConfig[] | undefined;
+  EngineConfigs?: EngineConfig[] | undefined;
+  VisualReferences?: VisualReferenceOutput[] | undefined;
   Tags?: Record<string, string> | undefined;
   ArtifactConfig?: ArtifactConfigOutput | undefined;
   DryRunConfig?: DryRunConfigOutput | undefined;
@@ -230,6 +246,7 @@ export interface CanaryRun {
   Timeline?: CanaryRunTimeline | undefined;
   ArtifactS3Location?: string | undefined;
   DryRunConfig?: CanaryDryRunConfigOutput | undefined;
+  BrowserType?: BrowserType | undefined;
 }
 export interface CanaryLastRun {
   CanaryName?: string | undefined;
@@ -280,6 +297,7 @@ export interface CreateCanaryRequest {
   VpcConfig?: VpcConfigInput | undefined;
   ResourcesToReplicateTags?: ResourceToTag[] | undefined;
   ProvisionedResourceCleanup?: ProvisionedResourceCleanupSetting | undefined;
+  BrowserConfigs?: BrowserConfig[] | undefined;
   Tags?: Record<string, string> | undefined;
   ArtifactConfig?: ArtifactConfigInput | undefined;
 }
@@ -331,6 +349,7 @@ export interface DescribeCanariesLastRunRequest {
   NextToken?: string | undefined;
   MaxResults?: number | undefined;
   Names?: string[] | undefined;
+  BrowserType?: BrowserType | undefined;
 }
 export interface DescribeCanariesLastRunResponse {
   CanariesLastRun?: CanaryLastRun[] | undefined;
@@ -450,6 +469,7 @@ export interface StartCanaryResponse {}
 export interface VisualReferenceInput {
   BaseScreenshots?: BaseScreenshot[] | undefined;
   BaseCanaryRunId: string | undefined;
+  BrowserType?: BrowserType | undefined;
 }
 export interface StartCanaryDryRunRequest {
   Name: string | undefined;
@@ -464,6 +484,8 @@ export interface StartCanaryDryRunRequest {
   ArtifactS3Location?: string | undefined;
   ArtifactConfig?: ArtifactConfigInput | undefined;
   ProvisionedResourceCleanup?: ProvisionedResourceCleanupSetting | undefined;
+  BrowserConfigs?: BrowserConfig[] | undefined;
+  VisualReferences?: VisualReferenceInput[] | undefined;
 }
 export interface StartCanaryDryRunResponse {
   DryRunConfig?: DryRunConfigOutput | undefined;
@@ -497,5 +519,7 @@ export interface UpdateCanaryRequest {
   ArtifactConfig?: ArtifactConfigInput | undefined;
   ProvisionedResourceCleanup?: ProvisionedResourceCleanupSetting | undefined;
   DryRunId?: string | undefined;
+  VisualReferences?: VisualReferenceInput[] | undefined;
+  BrowserConfigs?: BrowserConfig[] | undefined;
 }
 export interface UpdateCanaryResponse {}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-synthetics",
   "description": "AWS SDK for JavaScript Synthetics Client for Node.js, Browser and React Native",
-  "version": "3.873.0",
+  "version": "3.874.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-synthetics",