@optimal/fn

@optimal/fn

Force V8 to try to optimize a function and check optimization status.

Use in benchmarking to optimize before running the benchmark.

Use in analysis to test if your functions can be optimized.

See tests for examples of what optimizes and what doesn't. [JS] [CS]

See:

1. article
2. another article
3. node benchmark helper

Install

npm install @optimal/fn --save

Usage

// 1. attempt to optimize a function and get its status
var optimize = require('@optimal/fn')

function fn() { }

var result = optimize(fn)

console.log(result)
// {
//    optimized: true,
//    always   : false,
//    maybe    : false,
//    TurboFan : false
// }

// 2. test a function to see if it's optimized:
var someOtherFn = getSomeOtherFn()
result = optimize.check(someOtherFn)

Result Properties

The result may contain these properties:

1. optimized - true when optimized, false otherwise
2. always - When function "is optimized" then always will be false. When function is "always optimized" then always will be true. When function will "never be optimized" then always is true (and optimized is false).
3. maybe - when function is "maybe deoptimized" then maybe is true, otherwise it is false.
4. TurboFan - when function is "optimized by TurboFan" then this is true, otherwise it is false.

MIT License

Changelog

0.1.0 - 2017/01/01

1. initial working version with tests with 100% coverage