The AL developer preview is still evolving with frequent updates. Follow us on the Dynamics NAV Team Blog for the announcements.

HandlerMethods Property

Specifies the handler methods that are used by the test method.

Applies To

AL test methods on test codeunits. A test method is a method that has the MethodType Property (Test Codeunits) set to Test.

Property Value

The handler method name as specified on the Methods tab of the AL Global window for the test codeunit.


If the test method uses more than one handler method, then you should separate the handler method names by a comma.


You use test codeunits and test methods to test your application. A handler method allows you to automate tests by handling instances when user interaction is required by the code that is being tested. In these instances, the test method calls the handler method, which is run instead of the user interface.

The following is some important information about handler methods:

  • To be a handler method, the MethodType Property (Test Codeunits) must set to one of the handler types: MessageHandler, ConfirmHandler, StrMenuHandler, PageHandler, ModalPageHandler, ReportHandler, RequestPageHandler, or FilterPageHandler.

  • A test method can only call handler methods that are defined in the same test codeunit as the test method.

  • A test method can call MessageHandler, ConfirmHandler, and StrMenuHandler type handlers only once. It can call PageHandler, ModalPageHandler, ReportHandler, RequestPageHandler, or FilterPageHandler type handlers multiple times but only once per application object ID.

  • Every handler method that you enter in the HandlerMethods property must be called at least once in the test method. If you execute a test method that has a handler method listed that is not called, then the test fails.

See Also

AL Methods