HandlerFunctions attribute

Version: Available or changed with runtime version 1.0.

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

• Method

[HandlerFunctions(HandlerNames: Text)]

HandlerNames
 Type: Text
The names of the handler methods used by the test method.

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 method must have set to one of the attributes:
  MessageHandler
  ConfirmHandler
  StrMenuHandler
  PageHandler
  ModalPageHandler
  ReportHandler
  RequestPageHandler
  SendNotificationHandler
  HyperLinkHandler
  RecallNotificationHandler
  SessionSettingsHandler
  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 HandlerFunctions attribute 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.

You use handler methods to automate tests by handling instances when user interaction is required by the code that is being tested by the test method. In these instances, the handler method is run instead of the requested user interface. The handler method should simulate the user interaction for the test case, such as validating messages, making selections, or entering values. You declare a handler type attribute on the method. For more information about handler methods, see Create Handler Methods.

[Test]
[HandlerFunctions('SendNotificationHandler,MessageHandler')]
procedure MyTestFunction()
begin
    ...
end

Get Started with AL
Developing Extensions