Version 2.1.5

### Changelog

 - Changed behavior from throwing error in case `qrbox.width` or `qrbox` is larger
    than the width of the root element. In such cases the dimension will automatically
    be truncated to the size of root element and will throw a warning based on verbosity
    settings. This should address [issue#357](#357)

changelog.md

@@ -1,3 +1,10 @@
+### Version 2.1.5
+
+-   Changed behavior from throwing error in case `qrbox.width` or `qrbox` is larger
+    than the width of the root element. In such cases the dimension will automatically
+    be truncated to the size of root element and will throw a warning based on verbosity
+    settings. This should address [issue#357](https://github.com/mebjas/html5-qrcode/issues/357)
+
 ### Version 2.1.4
 
 #### Huge thanks to [Ben Richardson](https://github.com/ben-gy) for one time sponsorship!!

package.json

@@ -1,6 +1,6 @@
 {
   "name": "html5-qrcode",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "A cross platform HTML5 QR Code & bar code scanner",
   "main": "./cjs/index.js",
   "module": "./esm/index.js",

src/html5-qrcode.ts

@@ -968,7 +968,7 @@ export class Html5Qrcode {
      */
     private validateQrboxSize(
         internalConfig: InternalHtml5QrcodeConfig,
-        rootElementWidth: Number) {
+        rootElementWidth: number) {
         const qrboxSize = internalConfig.qrbox!;
         this.validateQrboxConfig(qrboxSize);
         let qrDimensions = this.toQrdimensions(qrboxSize);
@@ -980,16 +980,28 @@ export class Html5Qrcode {
             }
         };
 
-        const validateAgainstRootElementSize = (size: number) => {
-            if (size > rootElementWidth) {
-                throw "'config.qrbox' dimensions values should not be greater "
-                    + "than the width of the HTML element.";
+        /**
+         * The 'config.qrbox.width' shall be overriden if it's larger than the
+         * width of the root element.
+         * 
+         * Based on the verbosity settings, this will be logged to the logger.
+         * 
+         * @param configWidth the width of qrbox set by users in the config.
+         */
+        const correctWidthBasedOnRootElementSize = (configWidth: number) => {
+            if (configWidth > rootElementWidth) {
+                this.logger.warn("`qrbox.width` or `qrbox` is larger than the"
+                    + " width of the root element. The width will be truncated"
+                    + " to the width of root element.");
+                configWidth = rootElementWidth;
             }
+            return configWidth;
         };
 
         validateMinSize(qrDimensions.width);
         validateMinSize(qrDimensions.height);
-        validateAgainstRootElementSize(qrDimensions.width);
+        qrDimensions.width = correctWidthBasedOnRootElementSize(
+            qrDimensions.width);
         // Note: In this case if the height of the qrboxSize turns out to be
         // greater than the height of the root element (which should later be
         // based on the aspect ratio of the camera stream), it would be silently