excel - 为什么我的函数返回类型会在我读取 cell.value 或放入 console.log 后变成一个承诺
问题描述
我开始编写我的 Excel 工作表的验证代码。我实现了很多,所以我尽量保持代码简短。
我的源代码:
function main(workbook: ExcelScript.Workbook) {
console.log("starting...");
let cs = createVariantCategorySheet(workbook.getWorksheet("variant categories"));
cs.validateSheet();
for (let m of cs.logMessages) {
console.log(m);
}
console.log("finished...");
}
function createVariantCategorySheet(worksheet: ExcelScript.Worksheet): ImportSheet {
let sheet = new ImportSheetBuilder()
.name("variant categories")
.index(1)
.worksheet(worksheet)
.addColumnInfo(
new ColumnInfoBuilder()
.index(4)
.name("Sort Order")
// .addChecker(new NotEmptyChecker())
.addChecker(new UniqueSortOrderChecker(worksheet, worksheet.getRange("B:B")))
.build()
)
.build();
return sheet;
}
class ImportSheet {
public name: string;
public index: number;
public worksheet?: ExcelScript.Worksheet
columns: ColumnInfo[];
public logMessages: string[];
constructor() {
this.index = -1;
this.name = "";
this.columns = [];
this.logMessages = [];
}
// ... Some usefull private methods ...
validateSheet() {
let rowCount = this.getRowCount();
for (let rowIndex = 1; rowIndex < rowCount; rowIndex++) {
if (this.isRowEmpty(rowIndex)) {
this.logMessages.push("no more lines... ")
return;
}
this.validatingRow(rowIndex);
}
}
private validatingRow(rowIndex: number) {
this.logMessages.push("iterating over line [" + rowIndex + "]")
for (let columnItem of this.columns) {
this.validatingColumn(columnItem, this.rangeToValidate(rowIndex, columnItem.index));
}
}
private validatingColumn(columnItem: ColumnInfo, rangeToValidate: ExcelScript.Range){
for (let validator of columnItem.validator) {
let stringToValidate = rangeToValidate.getValue().toString();
this.logMessages.push("###### " + validator.isValid)
if (!validator.isValid(stringToValidate, rangeToValidate.getRowIndex())) {
this.logMessages.push("## ## ERROR: Failed Validation " + validator.getName() +
" in '" + rangeToValidate.getAddress() + "' for column '" +
columnItem.name + "'.");
} else {
this.logMessages.push("## ## INFO: Success Validation " + validator.getName() +
" in '" + rangeToValidate.getAddress() + "' for column '" +
columnItem.name + "'.");
}
}
}
}
class ColumnInfo {
name: string;
index: number;
validator: Checker[];
}
interface Checker {
isValid(value: string, rowIndex: number): boolean
getName(): string
}
class NotEmptyChecker implements Checker {
isValid(value: string): boolean {
if (value)
return true;
else
return false;
}
getName(): string {
return NotEmptyChecker.name;
}
}
class UniqueSortOrderChecker implements Checker {
sortOrderMap: Map<string, Set<string>>;
range: ExcelScript.Range
worksheet: ExcelScript.Worksheet
constructor(worksheet: ExcelScript.Worksheet, range: ExcelScript.Range) {
this.range = range;
this.worksheet = worksheet;
this.sortOrderMap = new Map<string, Set<string>>();
}
isValid(value: string, rowIndex: number): boolean {
return true;
}
getName(): string {
return UniqueSortOrderChecker.name;
}
}
我省略了 Builders,因为他们只是创建对象。
上面的代码可以正常工作并像我希望的那样验证文件。
该方法的生成代码UniqueSortOrderChecker.isValid
如下所示:
function (value, rowIndex) {
ExcelScript.engine.traceLine(undefined);
return true;
}
所以有趣的部分是,一旦我改变UniqueSortOrderChecker
成:
isValid(value: string, rowIndex: number): boolean {
console.log("test");
return true;
}
生成的代码现在看起来完全不同并返回一个承诺:
function (value, rowIndex) {
return __awaiter(this, void 0, void 0, function () {
return __generator(this, function (_a) {
switch (_a.label) {
case 0:
ExcelScript.engine.traceLine(264);
return [4 /*yield*/, console.log("test")];
case 1:
(_a.sent());
ExcelScript.engine.traceLine(undefined);
return [2 /*return*/, true];
}
});
});
}
当我尝试读取单元格值时也会发生同样的情况:
isValid(value: string, rowIndex: number): boolean {
let cellValue = this.range.getRow(rowIndex).getValue().toString();
return true;
}
把它变成一个承诺返回类型,如:
function (value, rowIndex) {
return __awaiter(this, void 0, void 0, function () {
var cellValue;
return __generator(this, function (_a) {
switch (_a.label) {
case 0:
ExcelScript.engine.traceLine(264);
return [4 /*yield*/, this.range.getRow(rowIndex).getValue()];
case 1:
cellValue = (_a.sent()).toString();
ExcelScript.engine.traceLine(undefined);
return [2 /*return*/, true];
}
});
});
}
有谁可以帮我离开这里吗?一旦它变成一个承诺,返回值总是真实的,我的验证不起作用。
希望这个问题不会太长,但我想给出上下文。
解决方案
Office Script 依赖于底层的一些复杂逻辑,为固有的异步代码提供同步执行的外观。
截至 2021 年 7 月 1 日,包括 console.log 在内的每个 Office 脚本方法都会返回一个承诺。正如你所发现的!
复杂的逻辑将等待应用于这些代码,以使它们与 IntelliSense 匹配并显示为同步。
该逻辑涵盖了截至 2021-07-01 的大多数常见情况,但是复杂的转换逻辑中存在一些差距,可能会遗漏某些情况。
类方法中尚不支持使用 Office 脚本方法和 console.log。
如果您今天必须在类中使用 Office 脚本方法或 console.log,您可以将这些类方法标记为异步并等待它们。
如果此功能对您的方案很重要,我建议在Office Script Editor
单击中发送反馈...
,然后单击Send Feedback
。
推荐阅读
- python - 如何在 python 中导入 csv 文件中的变量值?
- php - Mysql 插入 jQuery $(this).attr('id')
- python - Key Error: 1 在处理上述异常的过程中,又发生了一个异常
- wordpress - 如何将wordpress的插件升级到第五版?
- docker - 我的 cloudbuild.yaml 失败了。请查看我的 cloudbuild.yaml
- python - 下载 huggingface 预训练模型
- elasticsearch - 在 ElasticSearch 中实现搭配
- flutter - 我可以将持续时间设置为 fluttertoast 吗?
- ajax - Laravel Ajax 不工作,该路由不支持 GET 方法。支持的方法:POST
- c - 为什么我的输出后面多了一行?