@univerjs/sheets 0.23.0 → 0.24.0-insiders.20260528-29f582d

package/lib/cjs/facade.js

@@ -74,13 +74,13 @@ function __decorate(decorators, target, key, desc) {
 */
 function getDefinedNameFieldName(unitId, localeService, definedNamesService) {
 	const definedNameMap = definedNamesService.getDefinedNameMap(unitId);
-	if (definedNameMap == null) return localeService.t("definedName.defaultName") + 1;
+	if (definedNameMap == null) return localeService.t("sheets.definedName.defaultName") + 1;
 	const count = Array.from(Object.values(definedNameMap)).length + 1;
-	const name = localeService.t("definedName.defaultName") + count;
+	const name = localeService.t("sheets.definedName.defaultName") + count;
 	if (definedNamesService.getValueByName(unitId, name) == null) return name;
 	let i = count + 1;
 	while (true) {
-		const newName = localeService.t("definedName.defaultName") + i;
+		const newName = localeService.t("sheets.definedName.defaultName") + i;
 		if (definedNamesService.getValueByName(unitId, newName) == null) return newName;
 		i++;
 	}
@@ -580,7 +580,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A10:B11');
 	* fRange.activate();
 	* const fSelection = fWorksheet.getSelection();
@@ -598,7 +599,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fSelection = fWorksheet.getSelection();
 	* const activeRangeList = fSelection.getActiveRangeList();
 	* activeRangeList.forEach((range) => {
@@ -617,7 +619,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A10:B11');
 	* fRange.activate();
 	* const fSelection = fWorksheet.getSelection();
@@ -638,10 +641,11 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fSelection = fWorksheet.getSelection();
 	* const activeSheet = fSelection.getActiveSheet();
-	* console.log(activeSheet.equalTo(fWorksheet)); // true
+	* console.log(activeSheet.equalTo(fWorksheet));
 	* ```
 	*/
 	getActiveSheet() {
@@ -655,7 +659,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A10:B11');
 	* fRange.activate();
 	* const cell = fWorksheet.getRange('B11');
@@ -706,7 +711,8 @@ let FSelection = _FSelection = class FSelection {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // make sure the active cell is A1 and selection is A1:B2
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.activate();
@@ -1051,7 +1057,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Update the ranges to A1:C3 for the first rule
 	* if (rules.length > 0) {
@@ -1087,7 +1094,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Remove the first protection rule
 	* if (rules.length > 0) {
@@ -1126,7 +1134,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* // First, create a protection rule
 	* const rule = await fRange.getRangePermission().protect({ name: 'My Range', allowEdit: true });
@@ -1164,7 +1173,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows editing
 	* if (rules.length > 0) {
@@ -1191,7 +1201,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows editing
 	* const rule = rules[0];
@@ -1209,7 +1220,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows viewing
 	* const rule = rules[0];
@@ -1227,7 +1239,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows managing collaborators
 	* const rule = rules[0];
@@ -1245,7 +1258,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Check if the first rule allows deleting the rule
 	* const rule = rules[0];
@@ -1263,7 +1277,8 @@ let FRangeProtectionRule = class FRangeProtectionRule {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* // Get the permission snapshot of the first rule
 	* if (rules.length > 0) {
@@ -1313,7 +1328,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* if (fWorksheet.getWorksheetPermission().isProtected()) {
 	*   console.log('Worksheet is protected');
 	* }
@@ -1330,7 +1346,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const permission = fWorksheet.getWorksheetPermission();
 	*
 	* // Create worksheet protection with collaborators
@@ -1408,7 +1425,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().unprotect();
 	* ```
 	*/
@@ -1433,7 +1451,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setMode('readOnly');
 	* ```
 	*/
@@ -1473,7 +1492,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setReadOnly();
 	* ```
 	*/
@@ -1486,7 +1506,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* await fWorksheet.getWorksheetPermission().setEditable();
 	* ```
 	*/
@@ -1502,7 +1523,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const permission = fWorksheet.getWorksheetPermission();
 	* await permission.setPoint(univerAPI.Enum.WorksheetPermissionPoint.InsertRow, false);
 	* ```
@@ -1537,7 +1559,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* if (fWorksheet.getWorksheetPermission().canEdit()) {
 	*   console.log('Worksheet is editable');
 	* }
@@ -1554,7 +1577,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Check if cell C3 can be edited
 	* const fRange = fWorksheet.getRange('C3');
 	* const canEdit = fWorksheet.getWorksheetPermission().canEditCell(fRange.getRow(), fRange.getColumn());
@@ -1578,7 +1602,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* if (fWorksheet.getWorksheetPermission().canView()) {
 	*   console.log('Worksheet is viewable');
 	* }
@@ -1594,7 +1619,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Check if cell C3 can be viewed
 	* const fRange = fWorksheet.getRange('C3');
 	* const canView = fWorksheet.getWorksheetPermission().canViewCell(fRange.getRow(), fRange.getColumn());
@@ -1619,7 +1645,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const permission = fWorksheet.getWorksheetPermission();
 	* const canInsertRow = permission.getPoint(univerAPI.Enum.WorksheetPermissionPoint.InsertRow);
 	* console.log(canInsertRow);
@@ -1639,7 +1666,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const snapshot = fWorksheet.getWorksheetPermission().getSnapshot();
 	* console.log(snapshot);
 	* ```
@@ -1658,7 +1686,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @returns {Promise<void>} A promise that resolves when the configuration is applied.
 	* @example
 	* ```ts
-	* const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
+	* const worksheet = univerAPI.getActiveWorkbook()?.getSheetByName('Sheet1');
+	* if (!worksheet) return;
 	* const permission = worksheet?.getWorksheetPermission();
 	* await permission?.applyConfig({
 	*   mode: 'readOnly',
@@ -1689,7 +1718,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().protectRanges([
 	*   {
 	*     ranges: [fWorksheet.getRange('A1:B2')],
@@ -1778,7 +1808,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const worksheetPermission = fWorksheet.getWorksheetPermission();
 	* const rules = await worksheetPermission.listRangeProtectionRules();
 	* // Unprotect the first rule as an example
@@ -1804,7 +1835,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
 	* console.log(rules);
 	* ```
@@ -1823,7 +1855,8 @@ let FWorksheetPermission = class FWorksheetPermission extends _univerjs_core_fac
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get debug info for cell C3
 	* const fRange = fWorksheet.getRange('C3');
 	* const debugInfo = await fWorksheet.getWorksheetPermission().debugCellPermission(fRange.getRow(), fRange.getColumn());
@@ -1983,7 +2016,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 			* @returns This sheet, for chaining
 			* @example
 			* ```ts
-			* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+			* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+			* if (!fWorkSheet) return;
 			* fWorkSheet.setActiveSelection(fWorkSheet.getRange('A10:B10'));
 			* ```
 			*/
@@ -2002,7 +2036,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {Worksheet} The worksheet instance.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const sheet = fWorksheet.getSheet();
 	* console.log(sheet);
 	* ```
@@ -2015,7 +2050,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {Injector} The injector instance.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const injector = fWorksheet.getInject();
 	* console.log(injector);
 	* ```
@@ -2028,7 +2064,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {Workbook} The workbook instance.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const workbook = fWorksheet.getWorkbook();
 	* console.log(workbook);
 	* ```
@@ -2041,7 +2078,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {string} The id of the worksheet.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const sheetId = fWorksheet.getSheetId();
 	* console.log(sheetId);
 	* ```
@@ -2054,7 +2092,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {string} The name of the worksheet.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const sheetName = fWorksheet.getSheetName();
 	* console.log(sheetName);
 	* ```
@@ -2067,7 +2106,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FSelection} return the current selections of the worksheet or null if there is no selection.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const selection = fWorksheet.getSelection();
 	* console.log(selection);
 	* ```
@@ -2082,7 +2122,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {IStyleData} Default style of the worksheet.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const defaultStyle = fWorksheet.getDefaultStyle();
 	* console.log(defaultStyle);
 	* ```
@@ -2097,7 +2138,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {(Nullable<IStyleData> | string)} The default style of the worksheet row name or style data
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get default style for row 0 (1)
 	* const rowStyle = fWorksheet.getRowDefaultStyle(0);
 	* console.log(rowStyle);
@@ -2116,7 +2158,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {(Nullable<IStyleData> | string)} The default style of the worksheet column name or style data
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get default style for column 0 (A)
 	* const colStyle = fWorksheet.getColumnDefaultStyle(0);
 	* console.log(colStyle);
@@ -2134,7 +2177,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setDefaultStyle('default');
 	* // or
 	* // fWorksheet.setDefaultStyle({fs: 12, ff: 'Arial'});
@@ -2159,7 +2203,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setColumnDefaultStyle(0, 'default');
 	* // or
 	* // fWorksheet.setColumnDefaultStyle(0, {fs: 12, ff: 'Arial'});
@@ -2182,7 +2227,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setRowDefaultStyle(0, 'default');
 	* // or
 	* // fWorksheet.setRowDefaultStyle(0, {fs: 12, ff: 'Arial'});
@@ -2236,7 +2282,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {number} The maximum columns count of the sheet
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const totalColumns = fWorksheet.getMaxColumns();
 	* console.log(`Sheet has ${totalColumns} columns`);
 	* ```
@@ -2249,7 +2296,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {number}The maximum rows count of the sheet
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const totalRows = fWorksheet.getMaxRows();
 	* console.log(`Sheet has ${totalRows} rows`);
 	* ```
@@ -2263,7 +2311,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert a row after the third row
 	* fWorksheet.insertRowAfter(2);
 	* // Insert a row after the first row
@@ -2279,7 +2328,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert a row before the third row
 	* fWorksheet.insertRowBefore(2);
 	* // Insert a row before the first row
@@ -2296,7 +2346,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 rows before the third row
 	* fWorksheet.insertRows(2, 3);
 	* // Insert 1 row before the first row
@@ -2313,7 +2364,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 rows after the third row
 	* fWorksheet.insertRowsAfter(2, 3);
 	* // Insert 1 row after the first row
@@ -2350,7 +2402,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 rows before the third row
 	* fWorksheet.insertRowsBefore(2, 3);
 	* // Insert 1 row before the first row
@@ -2386,7 +2439,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete the third row
 	* fWorksheet.deleteRow(2);
 	* // Delete the first row
@@ -2403,7 +2457,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete 3 rows at row index 2 (rows 3-5)
 	* fWorksheet.deleteRows(2, 3);
 	* // Delete 1 row at row index 0 (first row)
@@ -2430,7 +2485,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete rows at index 2, and range from index 4 to 6 (rows 3, 5-7)
 	* fWorksheet.deleteRowsByPoints([2, [4, 6]]);
 	* ```
@@ -2448,7 +2504,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Move 3 rows at row index 2 (rows 3-5) to row index 0
 	* const rowSpec1 = fWorksheet.getRange('3:5');
 	* fWorksheet.moveRows(rowSpec1, 0);
@@ -2483,7 +2540,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Hide 3 rows starting from row index 1 (rows 2-4)
 	* const row1 = fWorksheet.getRange('2:4');
 	* fWorksheet.hideRow(row1);
@@ -2510,7 +2568,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Hide 3 rows starting from row index 1 (rows 2-4)
 	* fWorksheet.hideRows(1, 3);
 	* // Hide single row at index 0 (first row)
@@ -2540,7 +2599,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining.
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Unhide 3 rows starting from row index 1 (rows 2-4)
 	* const row1 = fWorksheet.getRange('2:4');
 	* fWorksheet.unhideRow(row1);
@@ -2567,7 +2627,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Show 3 rows starting from row index 1 (rows 2-4)
 	* fWorksheet.showRows(1, 3);
 	* // Show single row at index 0 (first row)
@@ -2598,7 +2659,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Set the height of the second row to 30 pixels
 	* fWorksheet.setRowHeight(1, 30);
 	* // Set the height of the first row to 20 pixels
@@ -2615,7 +2677,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.autoFitRow(24);
 	* ```
 	*/
@@ -2651,7 +2714,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setRowHeights(1, 10, 30);
 	* ```
 	*/
@@ -2693,7 +2757,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // Set the value of the cell A1 to 'Hello, Univer!', set the font size to 30 and font weight to bold
 	* const fRange = fWorksheet.getRange('A1');
@@ -2713,7 +2778,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setRowAutoHeight(1, 10);
 	* ```
 	*/
@@ -2739,7 +2805,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const ranges = [
 	* { startRow: 1, endRow: 10, startColumn: 0, endColumn: 10 },
 	* { startRow: 11, endRow: 20, startColumn: 0, endColumn: 10 },
@@ -2765,7 +2832,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.setRowHeightsForced(1, 10, 30);
 	* ```
 	*/
@@ -2792,7 +2860,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setRowCustom({ 0: { key: 'value' } });
 	* ```
 	*/
@@ -2815,7 +2884,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert a column after column C
 	* fWorksheet.insertColumnAfter(2);
 	* // Insert a column after column A
@@ -2831,7 +2901,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert a column before column C
 	* fWorksheet.insertColumnBefore(2);
 	* // Insert a column before column A
@@ -2848,7 +2919,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 columns before column C
 	* fWorksheet.insertColumns(2, 3);
 	* // Insert 1 column before column A
@@ -2865,7 +2937,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 columns after column C
 	* fWorksheet.insertColumnsAfter(2, 3);
 	* // Insert 1 column after column A
@@ -2902,7 +2975,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Insert 3 columns before column C
 	* fWorksheet.insertColumnsBefore(2, 3);
 	* // Insert 1 column before column A
@@ -2938,7 +3012,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete column C
 	* fWorksheet.deleteColumn(2);
 	* // Delete column A
@@ -2955,7 +3030,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete 3 columns at column index 2 (columns C, D, E)
 	* fWorksheet.deleteColumns(2, 3);
 	* // Delete 1 column at column index 0 (column A)
@@ -2982,7 +3058,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Delete columns at index 2, and range from index 4 to 6 (columns C, E-G)
 	* fWorksheet.deleteColumnsByPoints([2, [4, 6]]);
 	* ```
@@ -3000,7 +3077,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Move columns C, D, E to column index 2 (columns B, C, D)
 	* const columnSpec1 = fWorksheet.getRange('C:E');
 	* fWorksheet.moveColumns(columnSpec1, 1);
@@ -3035,7 +3113,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Hide columns C, D, E
 	* const column1 = fWorksheet.getRange('C:E');
 	* fWorksheet.hideColumn(column1);
@@ -3062,7 +3141,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Hide columns C, D, E
 	* fWorksheet.hideColumns(2, 3);
 	* // Hide column A
@@ -3092,7 +3172,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Unhide columns C, D, E
 	* const column1 = fWorksheet.getRange('C:E');
 	* fWorksheet.unhideColumn(column1);
@@ -3119,7 +3200,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Unhide columns C, D, E
 	* fWorksheet.showColumns(2, 3);
 	* // Unhide column A
@@ -3150,7 +3232,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Set width of column B to 100 pixels
 	* fWorksheet.setColumnWidth(1, 100);
 	* ```
@@ -3166,7 +3249,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Set width of columns B-D (index 1-3) to 100 pixels
 	* fWorksheet.setColumnWidths(1, 3, 100);
 	* ```
@@ -3195,7 +3279,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // Set the long text value in cell A1
 	* const fRange = fWorksheet.getRange('A1');
@@ -3217,7 +3302,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setColumnCustom({ 0: { key: 'value' } });
 	* ```
 	*/
@@ -3239,7 +3325,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange[]} All the merged cells in the worksheet
 	* @example
 	* ```ts
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get all merged ranges in the sheet
 	* const mergedData = fWorksheet.getMergeData();
 	* // Process each merged range
@@ -3256,7 +3343,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange[]} all merged cells
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get all merged ranges in the sheet
 	* const mergedRanges = fWorksheet.getMergedRanges();
 	* // Process each merged range
@@ -3275,7 +3363,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange|undefined} The merged cell data, or undefined if the cell is not merged
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const merge = fWorkSheet.getCellMergeData(0, 0);
 	* if (merge) {
 	*   console.log('Merged range:', merge.getA1Notation());
@@ -3291,7 +3380,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange | null} the active range
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get the currently active range
 	* const activeRange = fWorksheet.getActiveRange();
 	* if (activeRange) {
@@ -3308,7 +3398,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This sheet, for chaining
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setActiveRange(fWorkSheet.getRange('A10:B10'));
 	* ```
 	*/
@@ -3323,7 +3414,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FRange | null} The active cell
 	* @example
 	* ```typescript
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* console.log(fWorkSheet.getActiveCell().getA1Notation());
 	* ```
 	*/
@@ -3334,11 +3426,11 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* Sets the frozen state of the current sheet.
 	* @param {IFreeze} freeze - the scrolling viewport start range and count of freezed rows and columns.
 	* that means if you want to freeze the first 3 rows and 2 columns, you should set freeze as { startRow: 3, startColumn: 2, xSplit: 2, ySplit: 3 }
-	* @deprecated use `setFrozenRows` and `setFrozenColumns` instead.
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Freeze first 3 rows and 2 columns
 	* fWorksheet.setFreeze({
 	*   startRow: 3,
@@ -3349,7 +3441,6 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* ```
 	*/
 	setFreeze(freeze) {
-		this._logService.warn("setFreeze is deprecated, use setFrozenRows and setFrozenColumns instead");
 		this._commandService.syncExecuteCommand(_univerjs_sheets.SetFrozenCommand.id, {
 			...freeze,
 			unitId: this._workbook.getUnitId(),
@@ -3362,7 +3453,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} This worksheet instance for chaining
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Cancel freeze
 	* fWorksheet.cancelFreeze();
 	* ```
@@ -3379,7 +3471,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {IFreeze} The freeze state of the current sheet
 	* @example
 	* ```typescript
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* // Get the freeze state of the current sheet
 	* const freeze = fWorksheet.getFreeze();
 	* console.log(freeze);
@@ -3439,7 +3532,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {number} The number of frozen columns, returns 0 if no columns are frozen.
 	* @example
 	* ```typescript
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Get the number of frozen columns
 	* const frozenColumns = fWorkSheet.getFrozenColumns();
 	* console.log(frozenColumns);
@@ -3455,7 +3549,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {number} The number of frozen rows. returns 0 if no rows are frozen.
 	* @example
 	* ```typescript
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Get the number of frozen rows
 	* const frozenRows = fWorkSheet.getFrozenRows();
 	* console.log(frozenRows);
@@ -3471,7 +3566,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {IRowRange} The range of the frozen rows.
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Get the range of the frozen rows
 	* const frozenRows = fWorkSheet.getFrozenRowRange();
 	* console.log(frozenRows);
@@ -3489,7 +3585,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {IColumnRange} The range of the frozen columns.
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Get the range of the frozen columns
 	* const frozenColumns = fWorkSheet.getFrozenColumnRange();
 	* console.log(frozenColumns);
@@ -3507,7 +3604,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {boolean} True if the sheet's gridlines are hidden; otherwise false.
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // check if the gridlines are hidden
 	* if (fWorkSheet.hasHiddenGridLines()) {
 	*    console.log('Gridlines are hidden');
@@ -3523,7 +3621,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} Returns the current worksheet instance for method chaining
 	* @example
 	* ``` ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // hide the gridlines
 	* fWorkSheet.setHiddenGridlines(true);
 	* ```
@@ -3542,7 +3641,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheet} Returns the current worksheet instance for method chaining
 	* @example
 	* ```ts
-	* const fWorkSheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorkSheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // set the gridlines color to red
 	* fWorkSheet.setGridLinesColor('#ff0000');
 	* ```
@@ -3561,7 +3661,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // get the gridlines color of the sheet
 	* console.log(fWorkSheet.getGridLinesColor());
 	* ```
@@ -3576,7 +3677,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // set the tab color to red
 	* fWorkSheet.setTabColor('#ff0000');
 	* ```
@@ -3596,7 +3698,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // get the tab color of the sheet
 	* console.log(fWorkSheet.getTabColor());
 	* ```
@@ -3605,34 +3708,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 		return this._worksheet.getTabColor();
 	}
 	/**
-	* @deprecated use `univerAPI.addEvent(univerAPI.Event.SheetValueChanged, (params) => {})` instead
-	*/
-	onCellDataChange(callback) {
-		return this._injector.get(_univerjs_core.ICommandService).onCommandExecuted((command) => {
-			if (command.id === _univerjs_sheets.SetRangeValuesMutation.id) {
-				const params = command.params;
-				if (params.unitId === this._workbook.getUnitId() && params.subUnitId === this._worksheet.getSheetId() && params.cellValue) callback(new _univerjs_core.ObjectMatrix(params.cellValue));
-			}
-		});
-	}
-	/**
-	* @deprecated use `univerAPI.addEvent(univerAPI.Event.BeforeSheetEditEnd, (params) => {})` instead
-	*/
-	onBeforeCellDataChange(callback) {
-		return this._injector.get(_univerjs_core.ICommandService).beforeCommandExecuted((command) => {
-			if (command.id === _univerjs_sheets.SetRangeValuesMutation.id) {
-				const params = command.params;
-				if (params.unitId === this._workbook.getUnitId() && params.subUnitId === this._worksheet.getSheetId() && params.cellValue) callback(new _univerjs_core.ObjectMatrix(params.cellValue));
-			}
-		});
-	}
-	/**
 	* Hides this sheet. Has no effect if the sheet is already hidden. If this method is called on the only visible sheet, it throws an exception.
 	* @returns {FWorksheet} Returns the current worksheet instance for method chaining
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // hide the active sheet
 	* fWorkSheet.hideSheet();
 	* ```
@@ -3685,7 +3767,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // set the sheet name to 'Sheet1'
 	* fWorkSheet.setName('NewSheet1');
 	* ```
@@ -3719,7 +3802,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // get the position of the active sheet
 	* const position = fWorkSheet.getIndex();
 	* console.log(position);
@@ -3737,7 +3821,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // clear the sheet of content and formatting information
 	* fWorkSheet.clear();
 	* // clear the sheet of content only
@@ -3770,7 +3855,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // clear the sheet of content only
 	* fWorkSheet.clearContents();
 	* ```
@@ -3798,7 +3884,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // clear the sheet of formatting only
 	* fWorkSheet.clearFormats();
 	* ```
@@ -3822,12 +3909,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	}
 	/**
 	* Returns a Range corresponding to the dimensions in which data is present.
-	* This is functionally equivalent to creating a Range bounded by A1 and (Sheet.getLastColumn(), Sheet.getLastRow()).
+	* Empty cells with style or formatting will also be included in the data range. If there is no data on the sheet, returns a Range corresponding to the top-left cell of the sheet (A1).
 	* @returns {FRange} The range of the data in the sheet.
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Assume the sheet is a empty sheet
 	* const cellRange = fWorkSheet.getRange('J50');
 	* cellRange.setValue('Hello World');
@@ -3839,20 +3927,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 		return this.getRange(startRow, startColumn, endRow - startRow + 1, endColumn - startColumn + 1);
 	}
 	/**
-	* @deprecated use `getLastColumn` instead.
-	* Returns the column index of the last column that contains content.
-	* @returns {number} the column index of the last column that contains content.
-	*/
-	getLastColumns() {
-		return this._worksheet.getLastColumnWithContent();
-	}
-	/**
 	* Returns the column index of the last column that contains content.
 	* @returns {number} the column index of the last column that contains content.
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Assume the sheet is a empty sheet
 	* const cellRange = fWorkSheet.getRange('J50');
 	* cellRange.setValue('Hello World');
@@ -3863,20 +3944,13 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 		return this._worksheet.getLastColumnWithContent();
 	}
 	/**
-	* @deprecated use `getLastRow` instead.
-	* Returns the row index of the last row that contains content.
-	* @returns {number} the row index of the last row that contains content.
-	*/
-	getLastRows() {
-		return this._worksheet.getLastRowWithContent();
-	}
-	/**
 	* Returns the row index of the last row that contains content.
 	* @returns {number} the row index of the last row that contains content.
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* // Assume the sheet is a empty sheet
 	* const cellRange = fWorkSheet.getRange('J50');
 	* cellRange.setValue('Hello World');
@@ -3894,7 +3968,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
 	* const sheets = fWorkbook.getSheets();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* console.log(fWorkSheet.equalTo(sheets[0])); // true, if the active sheet is the first sheet.
 	* ```
 	*/
@@ -3909,7 +3984,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* // The code below inserts a defined name
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* fWorksheet.insertDefinedName('MyDefinedName', 'Sheet1!$A$1');
 	* ```
 	*/
@@ -3923,7 +3999,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* // The code below gets all the defined names in the worksheet
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const definedNames = fWorksheet.getDefinedNames();
 	* console.log(definedNames, definedNames[0]?.getFormulaOrRefString());
 	* ```
@@ -3938,7 +4015,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setCustomMetadata({ key: 'value' });
 	* ```
 	*/
@@ -3952,7 +4030,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const custom = fWorkSheet.getCustomMetadata();
 	* console.log(custom);
 	* ```
@@ -3968,7 +4047,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setRowCustomMetadata(0, { key: 'value' });
 	* ```
 	*/
@@ -3984,7 +4064,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.setColumnCustomMetadata(0, { key: 'value' });
 	* ```
 	*/
@@ -3999,7 +4080,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const custom = fWorkSheet.getRowCustomMetadata(0);
 	* console.log(custom);
 	* ```
@@ -4014,7 +4096,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const custom = fWorkSheet.getColumnCustomMetadata(0);
 	* console.log(custom);
 	* ```
@@ -4031,7 +4114,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* // Appends a new row with 4 columns to the bottom of the current
 	* // data region in the sheet containing the values in the array.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* fWorkSheet.appendRow([1, 'Hello Univer', true, '=A1']);
 	* ```
 	*/
@@ -4061,7 +4145,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	*
 	* // Set the number of rows in the worksheet to 40
 	* fWorkSheet.setRowCount(40);
@@ -4082,7 +4167,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	*
 	* // Set the number of columns in the worksheet to 10
 	* fWorkSheet.setColumnCount(10);
@@ -4102,7 +4188,8 @@ let FWorksheet = _FWorksheet = class FWorksheet extends _univerjs_core_facade.FB
 	* @returns {FWorksheetPermission} - The WorksheetPermission instance.
 	* @example
 	* ```ts
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const permission = fWorksheet.getWorksheetPermission();
 	*
 	* // Set worksheet to read-only mode
@@ -4156,7 +4243,8 @@ let FRangePermission = class FRangePermission extends _univerjs_core_facade.FBas
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* // Check if the A1:B2 range is protected
 	* const isProtected = fRange.getRangePermission().isProtected();
@@ -4173,7 +4261,8 @@ let FRangePermission = class FRangePermission extends _univerjs_core_facade.FBas
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* const rule = await fRange.getRangePermission().protect({
 	*   name: 'My protected range',
@@ -4243,7 +4332,8 @@ let FRangePermission = class FRangePermission extends _univerjs_core_facade.FBas
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* const result = await fRange.getRangePermission().unprotect();
 	* console.log(result);
@@ -4265,7 +4355,8 @@ let FRangePermission = class FRangePermission extends _univerjs_core_facade.FBas
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* const rules = await fRange.getRangePermission().listRules();
 	* console.log(rules);
@@ -4309,7 +4400,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getUnitId());
 	* ```
@@ -4323,7 +4415,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getSheetName());
 	* ```
@@ -4337,7 +4430,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getSheetId());
 	* ```
@@ -4351,7 +4445,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* const range = fRange.getRange();
 	* const { startRow, startColumn, endRow, endColumn } = range;
@@ -4367,7 +4462,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getRow()); // 0
 	* ```
@@ -4381,7 +4477,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getLastRow()); // 1
 	* ```
@@ -4395,7 +4492,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getColumn()); // 0
 	* ```
@@ -4409,7 +4507,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getLastColumn()); // 1
 	* ```
@@ -4423,7 +4522,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getWidth());
 	* ```
@@ -4437,7 +4537,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getHeight());
 	* ```
@@ -4451,7 +4552,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.isMerged());
 	* // merge cells A1:B2
@@ -4476,7 +4578,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellStyleData());
 	* ```
@@ -4497,7 +4600,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getFontFamily());
 	* ```
@@ -4518,7 +4622,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getFontSize());
 	* ```
@@ -4539,7 +4644,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellStyle());
 	* ```
@@ -4560,7 +4666,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellStyles());
 	* ```
@@ -4583,7 +4690,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValueForCell({
 	*   v: 0.2,
@@ -4608,7 +4716,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValueForCell({
 	*   v: 0.2,
@@ -4647,7 +4756,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [
@@ -4708,7 +4818,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [
@@ -4768,7 +4879,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellData());
 	* ```
@@ -4783,7 +4895,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellDatas());
 	* ```
@@ -4797,7 +4910,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCellDataGrid());
 	* ```
@@ -4820,7 +4934,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getRichTextValue());
 	* ```
@@ -4838,7 +4953,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getRichTextValues());
 	* ```
@@ -4854,7 +4970,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getValueAndRichTextValue());
 	* ```
@@ -4869,7 +4986,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getValueAndRichTextValues());
 	* ```
@@ -4883,7 +5001,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getFormula());
 	* ```
@@ -4898,7 +5017,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getFormulas());
 	* ```
@@ -4924,7 +5044,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getWrap());
 	* ```
@@ -4938,7 +5059,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getWraps());
 	*/
@@ -4956,7 +5078,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getWrapStrategy());
 	* ```
@@ -4970,7 +5093,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getHorizontalAlignment());
 	* ```
@@ -4984,7 +5108,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getHorizontalAlignments());
 	* ```
@@ -4998,7 +5123,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getVerticalAlignment());
 	* ```
@@ -5012,7 +5138,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getVerticalAlignments());
 	* ```
@@ -5026,7 +5153,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRange} This range, for chaining
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setCustomMetaData({ key: 'value' });
 	* console.log(fRange.getCustomMetaData());
@@ -5048,7 +5176,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRange} This range, for chaining
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setCustomMetaDatas([
 	*   [{ key: 'value' }, { key: 'value2' }],
@@ -5073,7 +5202,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCustomMetaData());
 	* ```
@@ -5089,7 +5219,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getCustomMetaDatas());
 	* ```
@@ -5109,7 +5240,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setBorder(univerAPI.Enum.BorderType.ALL, univerAPI.Enum.BorderStyleTypes.THIN, '#ff0000');
 	* ```
@@ -5133,7 +5265,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getBackground());
 	* ```
@@ -5149,7 +5282,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getBackgrounds());
 	* ```
@@ -5167,7 +5301,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setBackgroundColor('red');
 	* ```
@@ -5191,7 +5326,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setBackground('red');
 	* ```
@@ -5207,7 +5343,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setTextRotation(45);
 	* ```
@@ -5227,7 +5364,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRange} This range, for chaining
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('B2');
 	* fRange.setValue(123);
 	*
@@ -5252,7 +5390,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRange} This range, for chaining
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValueForCell(123);
 	*
@@ -5283,7 +5422,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getValue(true));
 	*
@@ -5319,7 +5459,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getValue(true));
 	*
@@ -5354,7 +5495,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setWrap(true);
 	* console.log(fRange.getWrap());
@@ -5376,7 +5518,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setWrapStrategy(univerAPI.Enum.WrapStrategy.WRAP);
 	* console.log(fRange.getWrapStrategy());
@@ -5398,7 +5541,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setVerticalAlignment('top');
 	* ```
@@ -5419,7 +5563,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setHorizontalAlignment('left');
 	* ```
@@ -5440,7 +5585,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [1, { v: 2, s: { bg: { rgb: '#ff0000' } } }],
@@ -5465,7 +5611,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontWeight('bold');
 	* ```
@@ -5496,7 +5643,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontStyle('italic');
 	* ```
@@ -5527,7 +5675,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontLine('underline');
 	* ```
@@ -5587,7 +5736,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontFamily('Arial');
 	* ```
@@ -5613,7 +5763,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontSize(24);
 	* ```
@@ -5639,7 +5790,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFontColor('#ff0000');
 	* ```
@@ -5667,7 +5819,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.merge();
 	* console.log(fRange.isMerged());
@@ -5675,7 +5828,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	*
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('B1:C2');
 	* // Assume A1:B2 is already merged.
 	* fRange.merge({ isForceMerge: true });
@@ -5697,7 +5851,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet is a new sheet with no merged cells.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.mergeAcross();
 	* // There will be two merged cells. A1:B1 and A2:B2.
@@ -5709,7 +5864,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	*
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('B1:C2');
 	* // Assume A1:B2 is already merged.
 	* fRange.mergeAcross({ isForceMerge: true });
@@ -5732,7 +5888,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet is a new sheet with no merged cells.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.mergeVertically();
 	* // There will be two merged cells. A1:A2 and B1:B2.
@@ -5744,7 +5901,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	*
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('B1:C2');
 	* // Assume A1:B2 is already merged.
 	* fRange.mergeVertically({ isForceMerge: true });
@@ -5763,7 +5921,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.merge();
 	* const anchor = fWorksheet.getRange('A1');
@@ -5780,7 +5939,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.merge();
 	* const anchor = fWorksheet.getRange('A1');
@@ -5805,7 +5965,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @param {ICellData} callback.cell the cell data
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.forEach((row, col, cell) => {
 	*   console.log(row, col, cell);
@@ -5826,7 +5987,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {string} The A1 notation of the range.
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // By default, the A1 notation is returned without the sheet name and without absolute reference types.
 	* const fRange = fWorksheet.getRange('A1:B2');
@@ -5864,7 +6026,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.activate(); // the active cell will be A1
 	* ```
@@ -5882,7 +6045,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // Set the range A1:B2 as the active range, default active cell is A1
 	* const fRange = fWorksheet.getRange('A1:B2');
@@ -5934,7 +6098,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example Show how to split text to columns with custom delimiter
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // A1:A3 has following values:
 	* //     A   |
@@ -5976,7 +6141,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:E20');
 	* fRange.useThemeStyle('default');
 	* ```
@@ -5998,7 +6164,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:E20');
 	* fRange.removeThemeStyle('default');
 	* ```
@@ -6017,7 +6184,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:E20');
 	* console.log(fRange.getUsedThemeStyle()); // undefined
 	* fRange.useThemeStyle('default');
@@ -6040,7 +6208,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const fRange = fWorkSheet.getRange('A1:D10');
 	*
 	* // clear the content and format of the range A1:D10
@@ -6067,7 +6236,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const fRange = fWorkSheet.getRange('A1:D10');
 	*
 	* // clear the content only of the range A1:D10
@@ -6088,7 +6258,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```typescript
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorkSheet = fWorkbook.getActiveSheet();
+	* const fWorkSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorkSheet) return;
 	* const fRange = fWorkSheet.getRange('A1:D10');
 	* // clear the format only of the range A1:D10
 	* fRange.clearFormat();
@@ -6109,7 +6280,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet empty sheet.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const values = [
 	*   [1, 2, 3, 4],
 	*   [2, 3, 4, 5],
@@ -6168,7 +6340,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet empty sheet.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const values = [
 	*   [1, 2, 3, 4],
 	*   [2, 3, 4, 5],
@@ -6231,7 +6404,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet is a new sheet with no data.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	*
 	* // Set the range A1:D4 with some values, the range A1:D4 will be:
 	* //  |     |     |
@@ -6301,7 +6475,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Assume the active sheet is a new sheet with no data.
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.isBlank()); // true
 	*
@@ -6333,7 +6508,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* console.log(fRange.getA1Notation()); // A1:B2
 	*
@@ -6363,7 +6539,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1');
 	* fRange.setFormula('=SUM(A2:A5)');
 	* console.log(fRange.getFormula()); // '=SUM(A2:A5)'
@@ -6379,7 +6556,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setFormulas([
 	*   ['=SUM(A2:A5)', '=SUM(B2:B5)'],
@@ -6397,7 +6575,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* @returns {FRangePermission} - The RangePermission instance.
 	* @example
 	* ```ts
-	* const fWorksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+	* const fWorksheet = univerAPI.getActiveWorkbook().getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B10');
 	* const permission = fRange.getRangePermission();
 	*
@@ -6432,7 +6611,8 @@ let FRange = _FRange = class FRange extends _univerjs_core_facade.FBaseInitialab
 	* ```ts
 	* // Auto-fill the range D1:D10 based on the data in the range C1:C2
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:A4');
 	*
 	* // Auto-fill without specifying applyType (default behavior)
@@ -6935,6 +7115,7 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* // The code below gets the active sheet of the workbook
 	* const fWorkbook = univerAPI.getActiveWorkbook();
 	* const fWorksheet = fWorkbook.getActiveSheet();
+	* if (!fWorksheet) return;
 	* console.log(fWorksheet);
 	* ```
 	*/
@@ -7250,7 +7431,7 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	*/
 	onSelectionChange(callback) {
 		return (0, _univerjs_core.toDisposable)(this._selectionManagerService.selectionMoveEnd$.subscribe((selections) => {
-			if (this._univerInstanceService.getCurrentUnitForType(_univerjs_core.UniverInstanceType.UNIVER_SHEET).getUnitId() !== this.id) return;
+			if (this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_SHEET).getUnitId() !== this.id) return;
 			if (!(selections === null || selections === void 0 ? void 0 : selections.length)) callback([]);
 			else callback(selections.map((s) => s.range));
 		}));
@@ -7279,7 +7460,9 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* @example
 	* ```ts
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const range = fWorkbook.getActiveSheet().getRange('A10:B10');
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
+	* const range = fWorksheet.getRange('A10:B10');
 	* fWorkbook.setActiveRange(range);
 	* ```
 	*/
@@ -7357,7 +7540,8 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* ```ts
 	* // The code below duplicates the given worksheet
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const activeSheet = fWorkbook.getActiveSheet();
+	* const activeSheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!activeSheet) return;
 	* const duplicatedSheet = fWorkbook.duplicateSheet(activeSheet);
 	* console.log(duplicatedSheet);
 	* ```
@@ -7455,7 +7639,8 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* ```ts
 	* // The code below moves the sheet to the specified index
 	* const fWorkbook = univerAPI.getActiveWorkbook();
-	* const sheet = fWorkbook.getActiveSheet();
+	* const sheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!sheet) return;
 	* fWorkbook.moveSheet(sheet, 1);
 	* ```
 	*/
@@ -7776,7 +7961,8 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* fWorkbook.addStyles(styles);
 	*
 	* // Set values with the new styles
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [{ v: 'Hello', s: 'custom-style-1' }, { v: 'Univer', s: 'custom-style-1' }],
@@ -7811,7 +7997,8 @@ let FWorkbook = class FWorkbook extends _univerjs_core_facade.FBaseInitialable {
 	* fWorkbook.addStyles(styles);
 	*
 	* // Set values with the new styles
-	* const fWorksheet = fWorkbook.getActiveSheet();
+	* const fWorksheet = fWorkbook.getSheetByName('Sheet1');
+	* if (!fWorksheet) return;
 	* const fRange = fWorksheet.getRange('A1:B2');
 	* fRange.setValues([
 	*   [{ v: 'Hello', s: 'custom-style-1' }, { v: 'Univer', s: 'custom-style-1' }],
@@ -8165,7 +8352,7 @@ var FUniverSheetsMixin = class extends _univerjs_core_facade.FUniver {
 		return this.createUniverSheet(data, options);
 	}
 	getActiveWorkbook() {
-		const workbook = this._univerInstanceService.getCurrentUnitForType(_univerjs_core.UniverInstanceType.UNIVER_SHEET);
+		const workbook = this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_SHEET);
 		if (!workbook) return null;
 		return this._injector.createInstance(FWorkbook, workbook);
 	}