Known limitations

This page lists the known limitations of HyperFormula at its current development stage:

• Node.js versions older than 13 don't properly compare culture-insensitive strings. HyperFormula requires the full International Components for Unicode (ICU) to be supported. Learn more (opens new window)
• Multiple workbooks are not supported. One instance of HyperFormula can handle only one workbook with multiple worksheets at a time.
• For cycle detection, all possible dependencies between cells are taken into account, even if some of them could be omitted after the full evaluation of expressions and condition statements. The most prominent example of this behavior is the "IF" function which returns a cycle error regardless of whether TRUE or FALSE causes a circular reference.
• There is no data validation against named ranges. For example, you can't compare the arguments in a formula like this: =IF(firstRange>secondRange, TRUE, FALSE).
• Custom functions don't automatically recalculate the size of their result arrays when the formula dependencies change.
• There is no relative referencing in named ranges.
• The library doesn't offer (at least not yet) the following features:
  • 3D references
  • Constant arrays
  • Dynamic arrays
  • Asynchronous functions
  • Structured references ("Tables")
  • Relative named expressions
  • Functions cannot use UI metadata (e.g., hidden rows for SUBTOTAL).

Nuances of the implemented functions

• HyperFormula immediately instantiates references to single cells to their values, instead of treating them as 1-length ranges, which slightly changes the behavior of some functions (e.g., NPV).
• SUBTOTAL function does not ignore nested subtotals.
• CHISQ.INV, CHISQ.INV.RT, CHISQ.DIST.RT, CHIDIST, CHIINV and CHISQ.DIST (CHISQ.DIST in CDF mode): Running time grows linearly with the value of the second parameter, degrees_of_freedom (slow for values>1e7).
• GAMMA.DIST, GAMMA.INV, GAMMADIST, GAMMAINV (GAMMA.DIST and GAMMADIST in CDF mode): Running time grows linearly with the value of the second parameter, alpha (slow for values>1e7).
• For certain inputs, the RATE function might have no solutions, or have multiple solutions. Our implementation uses an iterative algorithm (Newton's method) to find an approximation for one of the solutions to within 1e-7. If the approximation is not found after 50 iterations, the RATE function returns the #NUM! error.
• The INDEX function doesn't support returning whole rows or columns of the source range – it always returns the contents of a single cell.
• The FILTER function accepts either single rows of equal width or single columns of equal height. In other words, all arrays passed to the FILTER function must have equal dimensions, and at least one of those dimensions must be 1.