Type Definition js::jsapi::LargeAllocationFailureCallback

type LargeAllocationFailureCallback = Option<unsafe extern "C" fn(data: *mut c_void)>;

If a large allocation fails when calling pod_{calloc,realloc}CanGC, the JS engine may call the large-allocation- failure callback, if set, to allow the embedding to flush caches, possibly perform shrinking GCs, etc. to make some room. The allocation will then be retried (and may still fail.)