Struct ScriptConfig 

pub struct ScriptConfig {
    pub limits: Limits,
    pub clock_ms: Option<i64>,
    pub timezone: Zone,
    pub printd_offset_secs: i32,
}

Available on crate feature javascript only.

What a scripting session is allowed to do, and what it sees.

Fields

limits: Limits

The bounds. Exhausting one is a diagnostic and a refusal.

clock_ms: Option<i64>

The clock scripts see, in milliseconds since the epoch.

None reads the host clock, which is the ordinary case and is the oracle’s too. Some freezes it, which is what a golden run needs — see ScriptConfig::frozen_at.

timezone: Zone

The local timezone scripts see through Date.

Configuration rather than something read from the machine, because it is in the expected bytes: every util.printd golden line is shifted to PDFium’s Los Angeles zone, and a golden run in another zone must still produce them.

A zone::Zone rather than an offset because the answer depends on the instant — Default gives UTC, which has no daylight term.

printd_offset_secs: i32

The offset util.printd applies before reading a date’s components — FX_LocalTime’s, which is not the one Date uses. See GOLDEN_PRINTD_OFFSET_SECS for why they differ.

Implementations

impl ScriptConfig

pub fn frozen_at(seconds: u64) -> ScriptConfig

The configuration for a run whose clock is frozen at seconds since the epoch.

The seed is the caller’s: a conformance run passes GOLDEN_CLOCK_SECS, an embedder its own instant.

The zone and printd’s offset come with it rather than being separately configurable, because the clock and the zone are frozen together — freezing the instant without freezing the zone reproduces neither.

A seconds past i64 milliseconds saturates rather than wrapping.

pub fn wall_clock() -> ScriptConfig

The configuration for a run with no --time=: the real wall clock, and the host’s own zone offsets left at whatever Default gives them.

This is the ordinary embedder’s configuration and the one a tool invoked without the flag builds.

Trait Implementations

impl Clone for ScriptConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ScriptConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ScriptConfig

fn default() -> Self

Returns the “default value” for a type.