survey-react-ui 1.9.121 → 1.9.123

package/README.md

@@ -1,5 +1,9 @@
 # SurveyJS React Form Library
 
+
+<video src="https://github.com/surveyjs/survey-library/assets/22315929/b24a68bf-d703-4096-835b-752f5f610aa6"></video>
+
+
 [![Build Status](https://dev.azure.com/SurveyJS/SurveyJS%20Integration%20Tests/_apis/build/status/SurveyJS%20Library?branchName=master)](https://dev.azure.com/SurveyJS/SurveyJS%20Integration%20Tests/_build/latest?definitionId=7&branchName=master)
 [![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE)
 <a href="https://github.com/DevExpress/testcafe">
@@ -44,4 +48,4 @@ Refer to instructions in the root README file: [Build the SurveyJS Form Library
 
 ## Licensing
 
-SurveyJS Form Library is distributed under the [MIT license](https://github.com/surveyjs/survey-library/blob/master/LICENSE).
+SurveyJS Form Library is distributed under the [MIT license](https://github.com/surveyjs/survey-library/blob/master/LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "survey-react-ui",
-  "version": "1.9.121",
+  "version": "1.9.123",
   "description": "survey.js is a JavaScript Survey Library. It is a modern way to add a survey to your website. It uses JSON for survey metadata and results.",
   "keywords": [
     "Survey",
@@ -20,9 +20,9 @@
     "url": "https://github.com/surveyjs/surveyjs.git"
   },
   "typings": "survey-react-ui.d.ts",
-  "dependencies": {
-    "survey-core": "1.9.121",
-    "react": "^16.5.0 || ^17.0.1 || ^18.1.0",
-    "react-dom": "^16.5.0 || ^17.0.1 || ^18.1.0"
+  "peerDependencies": {
+    "survey-core": "*",
+    "react": "^16.5.0 || ^17.0.1 || ^18.2.0",
+    "react-dom": "^16.5.0 || ^17.0.1 || ^18.2.0"
   }
 }

package/survey-react-ui.js

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.9.121
+ * surveyjs - Survey JavaScript library v1.9.123
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */
@@ -411,7 +411,7 @@ var Base = /** @class */ (function () {
      * Returns `true` if a passed `value` is an empty string, array, or object or if it equals to `undefined` or `null`.
      *
      * @param value A value to be checked.
-     * @param trimString (Optional) When this parameter is `true`, the method ignores whitespace characters at the beginning and end of a string value. Pass `false` to disable this functionality.
+     * @param trimString *(Optional)* When this parameter is `true`, the method ignores whitespace characters at the beginning and end of a string value. Pass `false` to disable this functionality.
      */
     Base.prototype.isValueEmpty = function (value, trimString) {
         if (trimString === void 0) { trimString = true; }
@@ -549,10 +549,12 @@ var Base = /** @class */ (function () {
      * The JSON object should contain only serializable properties of this SurveyJS object. Event handlers and properties that do not belong to the SurveyJS object are ignored.
      *
      * @param json A JSON object with properties that you want to apply to the current SurveyJS object.
+     * @param options An object with configuration options.
+     * @param {boolean} options.validatePropertyValues Pass `true` if you want to validate property values. Use the [`jsonErrors`](#jsonErrors) array to access validation errors.
      * @see toJSON
      */
-    Base.prototype.fromJSON = function (json) {
-        new _jsonobject__WEBPACK_IMPORTED_MODULE_2__["JsonObject"]().toObject(json, this);
+    Base.prototype.fromJSON = function (json, options) {
+        new _jsonobject__WEBPACK_IMPORTED_MODULE_2__["JsonObject"]().toObject(json, this, options);
         this.onSurveyLoad();
     };
     Base.prototype.onSurveyLoad = function () { };
@@ -618,7 +620,7 @@ var Base = /** @class */ (function () {
      * If the property is not found or does not have a value, this method returns either `undefined`, `defaultValue` specified in the property configuration, or a value passed as the `defaultValue` parameter.
      *
      * @param name A property name.
-     * @param defaultValue (Optional) A value to return if the property is not found or does not have a value.
+     * @param defaultValue *(Optional)* A value to return if the property is not found or does not have a value.
      */
     Base.prototype.getPropertyValue = function (name, defaultValue) {
         if (defaultValue === void 0) { defaultValue = null; }
@@ -889,7 +891,7 @@ var Base = /** @class */ (function () {
      * Registers a function to call when a property value changes.
      * @param propertyNames An array of one or multiple property names.
      * @param handler A function to call when one of the listed properties change.
-     * @param key (Optional) A key that identifies the current registration. If a function for one of the properties is already registered with the same key, the function will be overwritten. You can also use the key to subsequently unregister handlers.
+     * @param key *(Optional)* A key that identifies the current registration. If a function for one of the properties is already registered with the same key, the function will be overwritten. You can also use the key to subsequently unregister handlers.
      * @see unregisterPropertyChangedHandlers
      */
     Base.prototype.registerPropertyChangedHandlers = function (propertyNames, handler, key) {
@@ -901,7 +903,7 @@ var Base = /** @class */ (function () {
     /**
      * Unregisters value change event handlers for the specified properties.
      * @param propertyNames An array of one or multiple property names.
-     * @param key (Optional) A key of the registration that you want to cancel.
+     * @param key *(Optional)* A key of the registration that you want to cancel.
      * @see registerPropertyChangedHandlers
      */
     Base.prototype.unregisterPropertyChangedHandlers = function (propertyNames, key) {
@@ -2592,7 +2594,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
-Object(survey_core__WEBPACK_IMPORTED_MODULE_2__["checkLibraryVersion"])("" + "1.9.121", "survey-react-ui");
+Object(survey_core__WEBPACK_IMPORTED_MODULE_2__["checkLibraryVersion"])("" + "1.9.123", "survey-react-ui");
 
 
 /***/ }),
@@ -6930,7 +6932,7 @@ var Helpers = /** @class */ (function () {
         if (x["equals"])
             return x.equals(y);
         if (!!x.toJSON && !!y.toJSON && !!x.getType && !!y.getType) {
-            if (x.isDiposed || y.isDiposed)
+            if (x.isDisposed || y.isDisposed)
                 return false;
             if (x.getType() !== y.getType())
                 return false;
@@ -7236,7 +7238,7 @@ if (!String.prototype["format"]) {
 /*!***************************!*\
   !*** ./src/jsonobject.ts ***!
   \***************************/
-/*! exports provided: property, propertyArray, JsonObjectProperty, CustomPropertiesCollection, JsonMetadataClass, JsonMetadata, JsonError, JsonUnknownPropertyError, JsonMissingTypeErrorBase, JsonMissingTypeError, JsonIncorrectTypeError, JsonRequiredPropertyError, JsonRequiredArrayPropertyError, JsonObject, Serializer */
+/*! exports provided: property, propertyArray, JsonObjectProperty, CustomPropertiesCollection, JsonMetadataClass, JsonMetadata, JsonError, JsonUnknownPropertyError, JsonMissingTypeErrorBase, JsonMissingTypeError, JsonIncorrectTypeError, JsonRequiredPropertyError, JsonRequiredArrayPropertyError, JsonIncorrectPropertyValueError, JsonObject, Serializer */
 /***/ (function(module, __webpack_exports__, __webpack_require__) {
 
 "use strict";
@@ -7254,6 +7256,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "JsonIncorrectTypeError", function() { return JsonIncorrectTypeError; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "JsonRequiredPropertyError", function() { return JsonRequiredPropertyError; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "JsonRequiredArrayPropertyError", function() { return JsonRequiredArrayPropertyError; });
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "JsonIncorrectPropertyValueError", function() { return JsonIncorrectPropertyValueError; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "JsonObject", function() { return JsonObject; });
 /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "Serializer", function() { return Serializer; });
 /* harmony import */ var _surveyStrings__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./surveyStrings */ "./src/surveyStrings.ts");
@@ -7590,6 +7593,12 @@ var JsonObjectProperty = /** @class */ (function () {
             }
         }
     };
+    JsonObjectProperty.prototype.validateValue = function (value) {
+        var choices = this.choices;
+        if (!Array.isArray(choices) || choices.length === 0)
+            return true;
+        return choices.indexOf(value) > -1;
+    };
     JsonObjectProperty.prototype.getObjType = function (objType) {
         if (!this.classNamePart)
             return objType;
@@ -8667,8 +8676,8 @@ var JsonMetadata = /** @class */ (function () {
     };
     JsonMetadata.prototype.getChemeRefName = function (className, isRoot) {
         //Fix for #6486, according to https://niem.github.io/json/reference/json-schema/references/#:~:text=In%20a%20JSON%20schema%2C%20a,%2C%20an%20in%2Dschema%20reference
-        return "#/definitions/" + className;
-        //return isRoot ? "#/definitions/" + className : className + "#";
+        //Checked by https://www.jsonschemavalidator.net/
+        return isRoot ? "#/definitions/" + className : className;
     };
     JsonMetadata.prototype.generateChemaClass = function (className, schemaDef, isRoot) {
         if (!!schemaDef[className])
@@ -8823,6 +8832,17 @@ var JsonRequiredArrayPropertyError = /** @class */ (function (_super) {
     return JsonRequiredArrayPropertyError;
 }(JsonError));
 
+var JsonIncorrectPropertyValueError = /** @class */ (function (_super) {
+    __extends(JsonIncorrectPropertyValueError, _super);
+    function JsonIncorrectPropertyValueError(property, value) {
+        var _this = _super.call(this, "incorrectvalue", "The property value: '" + value + "' is incorrect for property '" + property.name + "'.") || this;
+        _this.property = property;
+        _this.value = value;
+        return _this;
+    }
+    return JsonIncorrectPropertyValueError;
+}(JsonError));
+
 var JsonObject = /** @class */ (function () {
     function JsonObject() {
         this.errors = new Array();
@@ -8839,14 +8859,14 @@ var JsonObject = /** @class */ (function () {
         if (storeDefaults === void 0) { storeDefaults = false; }
         return this.toJsonObjectCore(obj, null, storeDefaults);
     };
-    JsonObject.prototype.toObject = function (jsonObj, obj) {
-        this.toObjectCore(jsonObj, obj);
+    JsonObject.prototype.toObject = function (jsonObj, obj, options) {
+        this.toObjectCore(jsonObj, obj, options);
         var error = this.getRequiredError(obj, jsonObj);
         if (!!error) {
             this.addNewError(error, jsonObj, obj);
         }
     };
-    JsonObject.prototype.toObjectCore = function (jsonObj, obj) {
+    JsonObject.prototype.toObjectCore = function (jsonObj, obj, options) {
         if (!jsonObj)
             return;
         var properties = null;
@@ -8864,6 +8884,7 @@ var JsonObject = /** @class */ (function () {
             obj.startLoadingFromJson(jsonObj);
         }
         properties = this.addDynamicProperties(obj, jsonObj, properties);
+        this.options = options;
         for (var key in jsonObj) {
             if (key === JsonObject.typePropertyName)
                 continue;
@@ -8878,8 +8899,9 @@ var JsonObject = /** @class */ (function () {
                 }
                 continue;
             }
-            this.valueToObj(jsonObj[key], obj, property, jsonObj);
+            this.valueToObj(jsonObj[key], obj, property, jsonObj, options);
         }
+        this.options = undefined;
         if (obj.endLoadingFromJson) {
             obj.endLoadingFromJson();
         }
@@ -8952,7 +8974,7 @@ var JsonObject = /** @class */ (function () {
             }
         }
     };
-    JsonObject.prototype.valueToObj = function (value, obj, property, jsonObj) {
+    JsonObject.prototype.valueToObj = function (value, obj, property, jsonObj, options) {
         if (value === null || value === undefined)
             return;
         this.removePos(property, value);
@@ -8966,17 +8988,22 @@ var JsonObject = /** @class */ (function () {
             this.addNewError(new JsonRequiredArrayPropertyError(propName, obj.getType()), !!jsonObj ? jsonObj : value, obj);
         }
         if (this.isValueArray(value)) {
-            this.valueToArray(value, obj, property.name, property);
+            this.valueToArray(value, obj, property.name, property, options);
             return;
         }
         var newObj = this.createNewObj(value, property);
         if (newObj.newObj) {
-            this.toObjectCore(value, newObj.newObj);
+            this.toObjectCore(value, newObj.newObj, options);
             value = newObj.newObj;
         }
         if (!newObj.error) {
             if (property != null) {
                 property.setValue(obj, value, this);
+                if (!!options && options.validatePropertyValues) {
+                    if (!property.validateValue(value)) {
+                        this.addNewError(new JsonIncorrectPropertyValueError(property, value), jsonObj, obj);
+                    }
+                }
             }
             else {
                 obj[property.name] = value;
@@ -9075,17 +9102,17 @@ var JsonObject = /** @class */ (function () {
         error.at = posObj.start;
         error.end = posObj.end;
     };
-    JsonObject.prototype.valueToArray = function (value, obj, key, property) {
+    JsonObject.prototype.valueToArray = function (value, obj, key, property, options) {
         if (obj[key] && !this.isValueArray(obj[key]))
             return;
         if (obj[key] && value.length > 0)
             obj[key].splice(0, obj[key].length);
         var valueRes = obj[key] ? obj[key] : [];
-        this.addValuesIntoArray(value, valueRes, property);
+        this.addValuesIntoArray(value, valueRes, property, options);
         if (!obj[key])
             obj[key] = valueRes;
     };
-    JsonObject.prototype.addValuesIntoArray = function (value, result, property) {
+    JsonObject.prototype.addValuesIntoArray = function (value, result, property, options) {
         for (var i = 0; i < value.length; i++) {
             var newValue = this.createNewObj(value[i], property);
             if (newValue.newObj) {
@@ -9096,7 +9123,7 @@ var JsonObject = /** @class */ (function () {
                     newValue.newObj.valueName = value[i].valueName.toString();
                 }
                 result.push(newValue.newObj);
-                this.toObjectCore(value[i], newValue.newObj);
+                this.toObjectCore(value[i], newValue.newObj, options);
             }
             else {
                 if (!newValue.error) {
@@ -9532,14 +9559,21 @@ var LocalizableString = /** @class */ (function () {
         if (this.htmlValues[loc] !== undefined)
             return !!this.htmlValues[loc];
         var renderedText = this.calculatedText;
-        if (!renderedText)
+        if (!renderedText) {
+            this.setHtmlValue(loc, "");
             return false;
-        if (!!this.getLocalizationName() && renderedText === this.getLocalizationStr())
+        }
+        if (!!this.getLocalizationName() && renderedText === this.getLocalizationStr()) {
+            this.setHtmlValue(loc, "");
             return false;
+        }
         var res = this.owner.getMarkdownHtml(renderedText, this.name);
-        this.htmlValues[loc] = res;
+        this.setHtmlValue(loc, res);
         return !!res;
     };
+    LocalizableString.prototype.setHtmlValue = function (loc, val) {
+        this.htmlValues[loc] = val;
+    };
     LocalizableString.prototype.getHtmlValue = function () {
         var loc = this.locale;
         if (!loc)
@@ -13121,6 +13155,9 @@ var SurveyQuestionDropdownBase = /** @class */ (function (_super) {
     SurveyQuestionDropdownBase.prototype.getValueCore = function () {
         return this.questionBase.renderedValue;
     };
+    SurveyQuestionDropdownBase.prototype.renderReadOnlyElement = function () {
+        return react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("div", null, this.question.readOnlyText);
+    };
     SurveyQuestionDropdownBase.prototype.renderSelect = function (cssClasses) {
         var _a, _b;
         var selectElement = null;
@@ -13130,7 +13167,7 @@ var SurveyQuestionDropdownBase = /** @class */ (function (_super) {
             // @ts-ignore
             selectElement = react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("div", { id: this.question.inputId, className: this.question.getControlClass(), disabled: true },
                 text,
-                react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("div", null, this.question.readOnlyText));
+                this.renderReadOnlyElement());
         }
         else {
             if (!this.question["dropdownListModel"]) {
@@ -15994,9 +16031,6 @@ var SurveyQuestionCheckboxItem = /** @class */ (function (_super) {
         _this.handleOnChange = function (event) {
             _this.question.clickItemHandler(_this.item, event.target.checked);
         };
-        _this.selectAllChanged = function (event) {
-            _this.question.toggleSelectAll();
-        };
         return _this;
     }
     SurveyQuestionCheckboxItem.prototype.getStateElement = function () {
@@ -16070,16 +16104,12 @@ var SurveyQuestionCheckboxItem = /** @class */ (function (_super) {
     });
     SurveyQuestionCheckboxItem.prototype.renderCheckbox = function (isChecked, otherItem) {
         var id = this.question.getItemId(this.item);
-        var text = !this.hideCaption ? this.renderLocString(this.item.locText) : "";
         var itemClass = this.question.getItemClass(this.item);
         var labelClass = this.question.getLabelClass(this.item);
-        var onItemChanged = this.item == this.question.selectAllItem
-            ? this.selectAllChanged
-            : this.handleOnChange;
         var itemLabel = !this.hideCaption ? react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("span", { className: this.cssClasses.controlLabel }, this.renderLocString(this.item.locText, this.textStyle)) : null;
         return (react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("div", { className: itemClass, role: "presentation" },
             react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("label", { className: labelClass },
-                react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("input", { className: this.cssClasses.itemControl, type: "checkbox", role: "option", name: this.question.name + this.item.value, value: this.item.value != "selectall" ? this.item.value : undefined, id: id, style: this.inputStyle, disabled: !this.question.getItemEnabled(this.item), checked: isChecked, onChange: onItemChanged }),
+                react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("input", { className: this.cssClasses.itemControl, type: "checkbox", role: "option", name: this.question.name + this.item.id, value: this.item.value, id: id, style: this.inputStyle, disabled: !this.question.getItemEnabled(this.item), checked: isChecked, onChange: this.handleOnChange }),
                 this.cssClasses.materialDecorator ?
                     react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("span", { className: this.cssClasses.materialDecorator }, this.question.itemSvgIcon ?
                         react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("svg", { className: this.cssClasses.itemDecorator },
@@ -17298,6 +17328,9 @@ var SurveyQuestionMatrixRow = /** @class */ (function (_super) {
                 td = (react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("td", { key: key, className: itemClass, onClick: getHandler ? getHandler(column) : function () { } }, this.renderLocString(this.question.getCellDisplayLocText(row.name, column))));
             }
             else {
+                var mobileSpan = this.question.isMobile ?
+                    (react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("span", { className: this.question.cssClasses.cellResponsiveTitle }, this.renderLocString(column.locText)))
+                    : undefined;
                 td = (react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("td", { key: key, "data-responsive-title": column.locText.renderedHtml, className: this.question.cssClasses.cell },
                     react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("label", { onMouseDown: this.handleOnMouseDown, className: itemClass },
                         react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("input", { id: inputId, type: "radio", className: this.cssClasses.itemValue, name: row.fullName, value: column.value, disabled: this.isDisplayMode, checked: isChecked, onChange: this.handleOnChange, "aria-required": this.question.a11y_input_ariaRequired, "aria-label": this.question.getCellAriaLabel(row.locText.renderedHtml, column.locText.renderedHtml), "aria-invalid": this.question.a11y_input_ariaInvalid, "aria-describedby": this.question.a11y_input_ariaDescribedBy }),
@@ -17305,7 +17338,7 @@ var SurveyQuestionMatrixRow = /** @class */ (function (_super) {
                             react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("svg", { className: this.cssClasses.itemDecorator },
                                 react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("use", { xlinkHref: this.question.itemSvgIcon })) :
                             null),
-                        react__WEBPACK_IMPORTED_MODULE_0__["createElement"]("span", { style: !this.question.isMobile ? { display: "none" } : undefined, className: this.question.cssClasses.cellResponsiveTitle }, this.renderLocString(column.locText)))));
+                        mobileSpan)));
             }
             tds.push(td);
         }
@@ -18874,6 +18907,14 @@ var SurveyQuestionTagbox = /** @class */ (function (_super) {
             select,
             comment));
     };
+    SurveyQuestionTagbox.prototype.renderReadOnlyElement = function () {
+        if (this.question.locReadOnlyText) {
+            return this.renderLocString(this.question.locReadOnlyText);
+        }
+        else {
+            return null;
+        }
+    };
     return SurveyQuestionTagbox;
 }(_dropdown_base__WEBPACK_IMPORTED_MODULE_2__["SurveyQuestionDropdownBase"]));
 
@@ -19865,14 +19906,8 @@ var settings = {
         showEmptyTitles: true
     },
     //#region designMode section, Obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.designMode.showEmptyDescriptions`](https://surveyjs.io/form-library/documentation/api-reference/settings#designMode) property instead.
-     */
     get allowShowEmptyDescriptionInDesignMode() { return this.designMode.showEmptyDescriptions; },
     set allowShowEmptyDescriptionInDesignMode(val) { this.designMode.showEmptyDescriptions = val; },
-    /**
-     * This property is obsolete. Use the [`settings.designMode.showEmptyTitles`](https://surveyjs.io/form-library/documentation/api-reference/settings#designMode) property instead.
-     */
     get allowShowEmptyTitleInDesignMode() { return this.designMode.showEmptyTitles; },
     set allowShowEmptyTitleInDesignMode(val) { this.designMode.showEmptyTitles = val; },
     //#endregion
@@ -19896,19 +19931,10 @@ var settings = {
         defaultLocaleName: "default"
     },
     //#region localization section, obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.localization.useLocalTimeZone`](https://surveyjs.io/form-library/documentation/api-reference/settings#localization) property instead.
-     */
     get useLocalTimeZone() { return this.localization.useLocalTimeZone; },
     set useLocalTimeZone(val) { this.localization.useLocalTimeZone = val; },
-    /**
-     * This property is obsolete. Use the [`settings.localization.storeDuplicatedTranslations`](https://surveyjs.io/form-library/documentation/api-reference/settings#localization) property instead.
-     */
     get storeDuplicatedTranslations() { return this.localization.storeDuplicatedTranslations; },
     set storeDuplicatedTranslations(val) { this.localization.storeDuplicatedTranslations = val; },
-    /**
-     * This property is obsolete. Use the [`settings.localization.defaultLocaleName`](https://surveyjs.io/form-library/documentation/api-reference/settings#localization) property instead.
-     */
     get defaultLocaleName() { return this.localization.defaultLocaleName; },
     set defaultLocaleName(val) { this.localization.defaultLocaleName = val; },
     //#endregion
@@ -19921,41 +19947,41 @@ var settings = {
      * Specifies whether to encode URL parameters when you access a web service. Default value: `true`.
      *
      * - `cacheLoadedChoices`: `boolean`\
-     * Specifies whether to cache [choices](https://surveyjs.io/form-library/documentation/api-reference/checkbox-question-model#choicesByUrl) loaded from a web service. Default value: `true`.
+     * Specifies whether to cache [choices loaded from a web service](https://surveyjs.io/form-library/documentation/api-reference/questionselectbase#choicesByUrl). Default value: `true`.
      *
      * - `disableQuestionWhileLoadingChoices`: `boolean`\
      * Disables a question while its choices are being loaded from a web service. Default value: `false`.
      *
      * - `surveyServiceUrl`: `string`\
      * The URL of the SurveyJS Service API endpoint.
+     *
+     * - `onBeforeRequestChoices`: `(sender: ChoicesRestful, options: { request: XMLHttpRequest })`\
+     * An event that is raised before a request for choices is send. Applies to questions with a specified [`choiceByUrl`](https://surveyjs.io/form-library/documentation/api-reference/questionselectbase#choicesByUrl) property. Use the `options.request` parameter to access and modify the `XMLHttpRequest` object. For instance, you can add authentication headers to it:
+     *
+     *     ```js
+     *     import { settings } from "survey-core";
+     *
+     *     settings.web.onBeforeSendRequest = (sender, options) => {
+     *       options.request.setRequestHeader('RequestVerificationToken', requestVerificationToken);
+     *     };
+     *     ```
      */
     web: {
+        onBeforeRequestChoices: function (sender, options) { },
         encodeUrlParams: true,
         cacheLoadedChoices: true,
         disableQuestionWhileLoadingChoices: false,
         surveyServiceUrl: "https://api.surveyjs.io/public/v1/Survey"
     },
     //#region web section, obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.web.encodeUrlParams`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) property instead.
-     */
     get webserviceEncodeParameters() { return this.web.encodeUrlParams; },
     set webserviceEncodeParameters(val) { this.web.encodeUrlParams = val; },
-    /**
-     * This property is obsolete. Use the [`settings.web.cacheLoadedChoices`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) property instead.
-     */
     get useCachingForChoicesRestful() { return this.web.cacheLoadedChoices; },
     set useCachingForChoicesRestful(val) { this.web.cacheLoadedChoices = val; },
     get useCachingForChoicesRestfull() { return this.web.cacheLoadedChoices; },
     set useCachingForChoicesRestfull(val) { this.web.cacheLoadedChoices = val; },
-    /**
-     * This property is obsolete. Use the [`settings.web.disableQuestionWhileLoadingChoices`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) property instead.
-     */
     get disableOnGettingChoicesFromWeb() { return this.web.disableQuestionWhileLoadingChoices; },
     set disableOnGettingChoicesFromWeb(val) { this.web.disableQuestionWhileLoadingChoices = val; },
-    /**
-     * This property is obsolete. Use the [`settings.web.surveyServiceUrl`](https://surveyjs.io/form-library/documentation/api-reference/settings#web) property instead.
-     */
     get surveyServiceUrl() { return this.web.surveyServiceUrl; },
     set surveyServiceUrl(val) { this.web.surveyServiceUrl = val; },
     //#endregion
@@ -19981,19 +20007,10 @@ var settings = {
         executeSkipOnValueChanged: true
     },
     //#region triggers section, Obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.triggers.executeCompleteOnValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/settings#triggers) property instead.
-     */
     get executeCompleteTriggerOnValueChanged() { return this.triggers.executeCompleteOnValueChanged; },
     set executeCompleteTriggerOnValueChanged(val) { this.triggers.executeCompleteOnValueChanged = val; },
-    /**
-     * This property is obsolete. Use the [`settings.triggers.changeNavigationButtonsOnComplete`](https://surveyjs.io/form-library/documentation/api-reference/settings#triggers) property instead.
-     */
     get changeNavigationButtonsOnCompleteTrigger() { return this.triggers.changeNavigationButtonsOnComplete; },
     set changeNavigationButtonsOnCompleteTrigger(val) { this.triggers.changeNavigationButtonsOnComplete = val; },
-    /**
-     * This property is obsolete. Use the [`settings.triggers.executeSkipOnValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/settings#triggers) property instead.
-     */
     get executeSkipTriggerOnValueChanged() { return this.triggers.executeSkipOnValueChanged; },
     set executeSkipTriggerOnValueChanged(val) { this.triggers.executeSkipOnValueChanged = val; },
     //#endregion
@@ -20031,19 +20048,10 @@ var settings = {
         localizableStringSerializeAsObject: false
     },
     //#region serialization section, Obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.serialization.itemValueSerializeAsObject`](https://surveyjs.io/form-library/documentation/api-reference/settings#serialization) property instead.
-     */
     get itemValueAlwaysSerializeAsObject() { return this.serialization.itemValueSerializeAsObject; },
     set itemValueAlwaysSerializeAsObject(val) { this.serialization.itemValueSerializeAsObject = val; },
-    /**
-     * This property is obsolete. Use the [`settings.serialization.itemValueSerializeDisplayText`](https://surveyjs.io/form-library/documentation/api-reference/settings#serialization) property instead.
-     */
     get itemValueAlwaysSerializeText() { return this.serialization.itemValueSerializeDisplayText; },
     set itemValueAlwaysSerializeText(val) { this.serialization.itemValueSerializeDisplayText = val; },
-    /**
-     * This property is obsolete. Use the [`settings.serialization.localizableStringSerializeAsObject`](https://surveyjs.io/form-library/documentation/api-reference/settings#serialization) property instead.
-     */
     get serializeLocalizableStringAsObject() { return this.serialization.localizableStringSerializeAsObject; },
     set serializeLocalizableStringAsObject(val) { this.serialization.localizableStringSerializeAsObject = val; },
     //#endregion
@@ -20062,9 +20070,6 @@ var settings = {
         firstBatchSize: 3
     },
     //#region lazyRender section, Obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.lazyRender.enabled`](https://surveyjs.io/form-library/documentation/api-reference/settings#lazyRender) property instead.
-     */
     get lazyRowsRendering() { return this.lazyRender.enabled; },
     set lazyRowsRendering(val) { this.lazyRender.enabled = val; },
     get lazyRowsRenderingStartRow() { return this.lazyRender.firstBatchSize; },
@@ -20114,34 +20119,16 @@ var settings = {
         rateSize: "small",
     },
     //#region matrix section, Obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.matrix.defaultRowName`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     get matrixDefaultRowName() { return this.matrix.defaultRowName; },
     set matrixDefaultRowName(val) { this.matrix.defaultRowName = val; },
-    /**
-     * This property is obsolete. Use the [`settings.matrix.defaultCellType`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     get matrixDefaultCellType() { return this.matrix.defaultCellType; },
     set matrixDefaultCellType(val) { this.matrix.defaultCellType = val; },
-    /**
-     * This property is obsolete. Use the [`settings.matrix.totalsSuffix`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     get matrixTotalValuePostFix() { return this.matrix.totalsSuffix; },
     set matrixTotalValuePostFix(val) { this.matrix.totalsSuffix = val; },
-    /**
-     * This property is obsolete. Use the [`settings.matrix.maxRowCount`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     get matrixMaximumRowCount() { return this.matrix.maxRowCount; },
     set matrixMaximumRowCount(val) { this.matrix.maxRowCount = val; },
-    /**
-     * This property is obsolete. Use the [`settings.matrix.maxRowCountInCondition`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     get matrixMaxRowCountInCondition() { return this.matrix.maxRowCountInCondition; },
     set matrixMaxRowCountInCondition(val) { this.matrix.maxRowCountInCondition = val; },
-    /**
-     * This property is obsolete. Use the [`settings.matrix.renderRemoveAsIcon`](https://surveyjs.io/form-library/documentation/api-reference/settings#matrix) property instead.
-     */
     get matrixRenderRemoveAsIcon() { return this.matrix.renderRemoveAsIcon; },
     set matrixRenderRemoveAsIcon(val) { this.matrix.renderRemoveAsIcon = val; },
     //#endregion
@@ -20163,14 +20150,8 @@ var settings = {
         maxPanelCountInCondition: 1
     },
     //#region panel section, Obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.panel.maxPanelCountInCondition`](https://surveyjs.io/form-library/documentation/api-reference/settings#panel) property instead.
-     */
     get panelDynamicMaxPanelCountInCondition() { return this.panel.maxPanelCountInCondition; },
     set panelDynamicMaxPanelCountInCondition(val) { this.panel.maxPanelCountInCondition = val; },
-    /**
-     * This property is obsolete. Use the [`settings.panel.maxPanelCount`](https://surveyjs.io/form-library/documentation/api-reference/settings#panel) property instead.
-     */
     get panelMaximumPanelCount() { return this.panel.maxPanelCount; },
     set panelMaximumPanelCount(val) { this.panel.maxPanelCount = val; },
     //#endregion
@@ -20191,14 +20172,8 @@ var settings = {
         textRenderMode: "input"
     },
     //#region readOnly section, Obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.readOnly.commentRenderMode`](https://surveyjs.io/form-library/documentation/api-reference/settings#readOnly) property instead.
-     */
     get readOnlyCommentRenderMode() { return this.readOnly.commentRenderMode; },
     set readOnlyCommentRenderMode(val) { this.readOnly.commentRenderMode = val; },
-    /**
-     * This property is obsolete. Use the [`settings.readOnly.textRenderMode`](https://surveyjs.io/form-library/documentation/api-reference/settings#readOnly) property instead.
-     */
     get readOnlyTextRenderMode() { return this.readOnly.textRenderMode; },
     set readOnlyTextRenderMode(val) { this.readOnly.textRenderMode = val; },
     //#endregion
@@ -20218,14 +20193,8 @@ var settings = {
         includeQuestionsWithHiddenTitle: false
     },
     //#region numbering section, Obsolete properties
-    /**
-     * This property is obsolete. Use the [`settings.numbering.includeQuestionsWithHiddenTitle`](https://surveyjs.io/form-library/documentation/api-reference/settings#numbering) property instead.
-     */
     get setQuestionVisibleIndexForHiddenTitle() { return this.numbering.includeQuestionsWithHiddenTitle; },
     set setQuestionVisibleIndexForHiddenTitle(val) { this.numbering.includeQuestionsWithHiddenTitle = val; },
-    /**
-     * This property is obsolete. Use the [`settings.numbering.includeQuestionsWithHiddenNumber`](https://surveyjs.io/form-library/documentation/api-reference/settings#numbering) property instead.
-     */
     get setQuestionVisibleIndexForHiddenNumber() { return this.numbering.includeQuestionsWithHiddenNumber; },
     set setQuestionVisibleIndexForHiddenNumber(val) { this.numbering.includeQuestionsWithHiddenNumber = val; },
     //#endregion