leaf_call_must_not_take_handle

FFI leaf call can't take arguments of type 'Handle'.

The analyzer produces this diagnostic when the value of the isLeaf argument in an invocation of either Pointer.asFunction or DynamicLibrary.lookupFunction is true and the function that would be returned would have a parameter of type Handle.

For more information about FFI, see C interop using dart:ffi.

The following code produces this diagnostic because the function p has a parameter of type Handle, but the isLeaf argument is true:

import 'dart:ffi';

void f(Pointer<NativeFunction<Void Function(Handle)>> p) {
  p.asFunction<void Function(Object)>(isLeaf: true);
}

If the function has at least one parameter of type Handle, then remove the isLeaf argument:

import 'dart:ffi';

void f(Pointer<NativeFunction<Void Function(Handle)>> p) {
  p.asFunction<void Function(Object)>();
}

If none of the function's parameters are Handles, then correct the type information:

import 'dart:ffi';

void f(Pointer<NativeFunction<Void Function(Int8)>> p) {
  p.asFunction<void Function(int)>(isLeaf: true);
}

Unless stated otherwise, the documentation on this site reflects Dart 3.8.1. Page last updated on 2025-05-08. View source or report an issue.