playwright-perl/lib/Playwright/Base.pm

package Playwright::Base;

use strict;
use warnings;

use Sub::Install();

use Playwright::Util();

#ABSTRACT: Object representing Playwright pages

no warnings 'experimental';
use feature qw{signatures};

=head2 DESCRIPTION

Base class for each Playwright class magic'd up by Sub::Install in Playwright's BEGIN block.
You probably shouldn't use this.

The specification for each class can be inspected with the 'spec' property:

    use Data::Dumper;
    my $object = Playwright::Base->new(...);
    print Dumper($object->{spec});

=head1 CONSTRUCTOR

=head2 new(HASH) = (Playwright::Base)

Creates a new page and returns a handle to interact with it.

=head3 INPUT

    handle (Playwright) : Playwright object.
    id (STRING)         : _guid returned by a response from the Playwright server with the provided type.
    type (STRING)       : Type to actually use

=cut

our %methods_to_rename = (
    '$'      => 'select',
    '$$'     => 'selectMulti',
    '$eval'  => 'eval',
    '$$eval' => 'evalMulti',
);

sub new ($class, %options) {

    my $self = bless({
        spec    => $Playwright::spec->{$options{type}}{members},
        type    => $options{type},
        guid    => $options{id},
        ua      => $options{handle}{ua},
        port    => $options{handle}{port},
    }, $class);

    # Hack in mouse and keyboard objects for the Page class
    if ($self->{type} eq 'Page') {
        foreach my $hid (qw{keyboard mouse}) {
            Sub::Install::install_sub({
                code => sub {
                    my $self = shift;
                    $Playwright::mapper{$hid}->($self, { _type => 'Page', _guid => $self->{guid} }) if exists $Playwright::mapper{$hid};
                },
                as   => $hid,
                into => $class,
            }) unless $self->can($hid);
        }
    }

    # Install the subroutines if they aren't already
    foreach my $method (keys(%{$self->{spec}})) {
        my $renamed = exists $methods_to_rename{$method} ? $methods_to_rename{$method} : $method;
        Sub::Install::install_sub({
            code => sub {
                my $self = shift;
                Playwright::Base::_request($self, args => [@_], command => $method, object => $self->{guid}, type => $self->{type} );
            },
            as   => $renamed,
            into => $class,
        }) unless $self->can($renamed);
    }

    return ($self);
}

sub _request ($self, %args) {
    my $msg = Playwright::Util::request ('POST', 'command', $self->{port}, $self->{ua}, %args);

    #TODO Check spec and see if we need to coerce a bool

    if (ref $msg eq 'ARRAY') {
        @$msg = map {
            my $subject = $_;
            $subject = $Playwright::mapper{$_->{_type}}->($self,$_) if (ref $_ eq 'HASH') && $_->{_type} && exists $Playwright::mapper{$_->{_type}};
            $subject
        } @$msg;
    }
    return $Playwright::mapper{$msg->{_type}}->($self,$msg) if (ref $msg eq 'HASH') && $msg->{_type} && exists $Playwright::mapper{$msg->{_type}};
    return $msg;
}

1;