24359589807

Committed 13 Apr 2026 06:19PM UTC coverage: 68.781% (-0.4%) from 69.192%

Build # 24359589807

Build Type

Pull #134

github

Committed by

web-flow

Commit Message

Merge deba06344 into ec1d6a961

Pull Request Pull Request #134: [WIP] Add support for PHP8's Nullsafe operator

Coverage Stats

18 of 38 new or added lines in 10 files covered. (47.37%)

10 existing lines in 2 files now uncovered.

1388 of 2018 relevant lines covered (68.78%)

225.24 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

45.71

/src/voku/helper/SimpleHtmlDomNode.php

<?php

declare(strict_types=1);

namespace voku\helper;

/**
 * {@inheritdoc}
 */
class SimpleHtmlDomNode extends AbstractSimpleHtmlDomNode implements SimpleHtmlDomNodeInterface
{
    /**
     * Find list of nodes with a CSS selector.
     *
     * @param string   $selector
     * @param int|null $idx
     *
     * @return SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>|SimpleHtmlDomNodeInterface[]|null
     */
    public function find(string $selector, $idx = null)
    {
        // init
        $elements = new static();

        foreach ($this as $node) {
            \assert($node instanceof SimpleHtmlDomInterface);
            foreach ($node->find($selector) as $res) {
                $elements[] = $res;
            }
        }

        // return all elements
        if ($idx === null) {
            if (\count($elements) === 0) {
                return new SimpleHtmlDomNodeBlank();
            }

            return $elements;
        }

        // handle negative values
        if ($idx < 0) {
            $idx = \count($elements) + $idx;
        }

        // return one element
        return $elements[$idx] ?? null;
    }

    /**
     * Find nodes with a CSS selector.
     *
     * @param string $selector
     *
     * @return SimpleHtmlDomInterface[]|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
     */
    public function findMulti(string $selector): SimpleHtmlDomNodeInterface
    {
        return $this->find($selector, null);
    }

    /**
     * Find nodes with a CSS selector.
     *
     * @param string $selector
     *
     * @return false|SimpleHtmlDomInterface[]|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
     */
    public function findMultiOrFalse(string $selector)
    {
        $return = $this->find($selector, null);

        if ($return instanceof SimpleHtmlDomNodeBlank) {
            return false;
        }

        return $return;
    }

    /**
     * Find nodes with a CSS selector or null, if no element is found.
     *
     * @param string $selector
     *
     * @return null|SimpleHtmlDomInterface[]|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
     */
    public function findMultiOrNull(string $selector)
    {
        $return = $this->find($selector, null);

        if ($return instanceof SimpleHtmlDomNodeBlank) {
            return null;
        }

        return $return;
    }

    /**
     * Find one node with a CSS selector.
     *
     * @param string $selector
     *
     * @return SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
     */
    public function findOne(string $selector)
    {
        $return = $this->find($selector, 0);

        return $return ?? new SimpleHtmlDomNodeBlank();
    }

    /**
     * Find one node with a CSS selector.
     *
     * @param string $selector
     *
     * @return false|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
     */
    public function findOneOrFalse(string $selector)
    {
        $return = $this->find($selector, 0);

        return $return ?? false;
    }

    /**
     * Find one node with a CSS selector or null, if no element is found.
     *
     * @param string $selector
     *
     * @return null|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
     */
    public function findOneOrNull(string $selector)
    {
        return $this->find($selector, 0);
    }

    /**
     * Get html of elements.
     *
     * @return string[]
     */
    public function innerHtml(): array
    {
        // init
        $html = [];

        foreach ($this as $node) {
            $html[] = $node->outertext;
        }

        return $html;
    }

    /**
     * alias for "$this->innerHtml()" (added for compatibly-reasons with v1.x)
     *
     * @return string[]
     */
    public function innertext()
    {
        return $this->innerHtml();
    }

    /**
     * alias for "$this->innerHtml()" (added for compatibly-reasons with v1.x)
     *
     * @return string[]
     */
    public function outertext()
    {
        return $this->innerHtml();
    }

    /**
     * Get plain text.
     *
     * @return string[]
     */
    public function text(): array
    {
        // init
        $text = [];

        foreach ($this as $node) {
            $text[] = $node->plaintext;
        }

        return $text;
    }
}

1	<?php
2
3	declare(strict_types=1);
4
5	namespace voku\helper;
6
7	/**
8	* {@inheritdoc}
9	*/
10	class SimpleHtmlDomNode extends AbstractSimpleHtmlDomNode implements SimpleHtmlDomNodeInterface
11	{
12	/**
13	* Find list of nodes with a CSS selector.
14	*
15	* @param string $selector
16	* @param int\|null $idx
17	*
18	* @return SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>\|SimpleHtmlDomNodeInterface[]\|null
19	*/
20	public function find(string $selector, $idx = null)
21	{
22	// init
23	$elements = new static();	77✔
24
25	foreach ($this as $node) {	77✔
26	\assert($node instanceof SimpleHtmlDomInterface);
27	foreach ($node->find($selector) as $res) {	77✔
28	$elements[] = $res;	70✔
29	}
30	}
31
32	// return all elements
33	if ($idx === null) {	77✔
34	if (\count($elements) === 0) {	77✔
35	return new SimpleHtmlDomNodeBlank();	7✔
36	}
37
38	return $elements;	70✔
39	}
40
41	// handle negative values
42	if ($idx < 0) {	×
43	$idx = \count($elements) + $idx;	×
44	}
45
46	// return one element
47	return $elements[$idx] ?? null;	×
48	}
49
50	/**
51	* Find nodes with a CSS selector.
52	*
53	* @param string $selector
54	*
55	* @return SimpleHtmlDomInterface[]\|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
56	*/
57	public function findMulti(string $selector): SimpleHtmlDomNodeInterface
58	{
59	return $this->find($selector, null);	×
60	}
61
62	/**
63	* Find nodes with a CSS selector.
64	*
65	* @param string $selector
66	*
67	* @return false\|SimpleHtmlDomInterface[]\|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
68	*/
69	public function findMultiOrFalse(string $selector)
70	{
71	$return = $this->find($selector, null);	×
72
73	if ($return instanceof SimpleHtmlDomNodeBlank) {	×
74	return false;	×
75	}
76
77	return $return;	×
78	}
79
80	/**
81	* Find nodes with a CSS selector or null, if no element is found.
82	*
83	* @param string $selector
84	*
85	* @return null\|SimpleHtmlDomInterface[]\|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
86	*/
87	public function findMultiOrNull(string $selector)
88	{
NEW 89	$return = $this->find($selector, null);	×
90
NEW 91	if ($return instanceof SimpleHtmlDomNodeBlank) {	×
NEW 92	return null;	×
93	}
94
NEW 95	return $return;	×
96	}
97
98	/**
99	* Find one node with a CSS selector.
100	*
101	* @param string $selector
102	*
103	* @return SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
104	*/
105	public function findOne(string $selector)
106	{
107	$return = $this->find($selector, 0);	×
108
109	return $return ?? new SimpleHtmlDomNodeBlank();	×
110	}
111
112	/**
113	* Find one node with a CSS selector.
114	*
115	* @param string $selector
116	*
117	* @return false\|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
118	*/
119	public function findOneOrFalse(string $selector)
120	{
121	$return = $this->find($selector, 0);	×
122
123	return $return ?? false;	×
124	}
125
126	/**
127	* Find one node with a CSS selector or null, if no element is found.
128	*
129	* @param string $selector
130	*
131	* @return null\|SimpleHtmlDomNodeInterface<SimpleHtmlDomInterface>
132	*/
133	public function findOneOrNull(string $selector)
134	{
NEW 135	return $this->find($selector, 0);	×
136	}
137
138	/**
139	* Get html of elements.
140	*
141	* @return string[]
142	*/
143	public function innerHtml(): array
144	{
145	// init
146	$html = [];	7✔
147
148	foreach ($this as $node) {	7✔
149	$html[] = $node->outertext;	7✔
150	}
151
152	return $html;	7✔
153	}
154
155	/**
156	* alias for "$this->innerHtml()" (added for compatibly-reasons with v1.x)
157	*
158	* @return string[]
159	*/
160	public function innertext()
161	{
UNCOV 162	return $this->innerHtml();	×
163	}
164
165	/**
166	* alias for "$this->innerHtml()" (added for compatibly-reasons with v1.x)
167	*
168	* @return string[]
169	*/
170	public function outertext()
171	{
UNCOV 172	return $this->innerHtml();	×
173	}
174
175	/**
176	* Get plain text.
177	*
178	* @return string[]
179	*/
180	public function text(): array
181	{
182	// init
183	$text = [];	49✔
184
185	foreach ($this as $node) {	49✔
186	$text[] = $node->plaintext;	49✔
187	}
188
189	return $text;	49✔
190	}
191	}

voku / simple_html_dom / 24359589807

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous