THPDFJavaScriptEvaluationResult Record

Outcome of a safe form-field JavaScript evaluation: executed and accepted flags, resulting value, operation count, error text, elapsed time and value size

Declaration

THPDFJavaScriptEvaluationResult= record
  Executed: boolean;
  Accepted: boolean;
  Value: AnsiString;
  OperationCount: Integer;
  ErrorText: AnsiString;
  ElapsedMilliseconds: Cardinal;
  ValueBytes: Int64;
end;

Unit

HPDFDoc

Fields

Field	Purpose
`Executed`	`true` when a JavaScript action attached to the field trigger really ran in the safe interpreter
`Accepted`	`true` when the sandbox accepted the script's result; rejected results must never be written back to the field
`Value`	Field value after the run: the interpreter output when accepted, otherwise the input value that went in
`OperationCount`	Interpreter operations used up by the script, against the configured script budget
`ErrorText`	Failure description, for example that the field trigger carries no JavaScript action, or else the sandbox's error message
`ElapsedMilliseconds`	Wall-clock time taken by the evaluation
`ValueBytes`	Byte length of the resulting value, measured against the output-size budget

Usage notes

Filled by THotPDF.EvaluateLoadedFieldJavaScript; on a false result the record still says why, typically in ErrorText
Write Value back to the field only when Accepted is true; the incremental recalculation helpers follow precisely this rule
Use OperationCount, ValueBytes and ElapsedMilliseconds together with the FormScriptBudgets property to diagnose budget violations

THPDFJavaScriptEvaluationResult Record

Declaration

Unit

Fields

Usage notes

Related APIs