Code Coverage |
||||||||||
Lines |
Functions and Methods |
Classes and Traits |
||||||||
Total | |
0.00% |
0 / 11 |
|
0.00% |
0 / 1 |
CRAP | |
0.00% |
0 / 1 |
ThreadItemTrait | |
0.00% |
0 / 11 |
|
0.00% |
0 / 1 |
12 | |
0.00% |
0 / 1 |
getId | n/a |
0 / 0 |
n/a |
0 / 0 |
0 | |||||
getType | n/a |
0 / 0 |
n/a |
0 / 0 |
0 | |||||
getReplies | n/a |
0 / 0 |
n/a |
0 / 0 |
0 | |||||
getLevel | n/a |
0 / 0 |
n/a |
0 / 0 |
0 | |||||
jsonSerialize | |
0.00% |
0 / 11 |
|
0.00% |
0 / 1 |
12 |
1 | <?php |
2 | |
3 | namespace MediaWiki\Extension\DiscussionTools\ThreadItem; |
4 | |
5 | trait ThreadItemTrait { |
6 | // phpcs:disable Squiz.WhiteSpace, MediaWiki.Commenting |
7 | // Required ThreadItem methods (listed for Phan) |
8 | abstract public function getId(): string; |
9 | abstract public function getType(): string; |
10 | abstract public function getReplies(): array; |
11 | abstract public function getLevel(): int; |
12 | // phpcs:enable |
13 | |
14 | /** |
15 | * @param bool $deep Whether to include full serialized comments in the replies key |
16 | * @param callable|null $callback Function to call on the returned serialized array, which |
17 | * will be passed into the serialized replies as well if $deep is used |
18 | * @return array JSON-serializable array |
19 | */ |
20 | public function jsonSerialize( bool $deep = false, ?callable $callback = null ): array { |
21 | // The output of this method can end up in the HTTP cache (Varnish). Avoid changing it; |
22 | // and when doing so, ensure that frontend code can handle both the old and new outputs. |
23 | // See ThreadItem.static.newFromJSON in JS. |
24 | |
25 | $array = [ |
26 | 'type' => $this->getType(), |
27 | 'level' => $this->getLevel(), |
28 | 'id' => $this->getId(), |
29 | 'replies' => array_map( static function ( ThreadItem $comment ) use ( $deep, $callback ) { |
30 | return $deep ? $comment->jsonSerialize( $deep, $callback ) : $comment->getId(); |
31 | }, $this->getReplies() ) |
32 | ]; |
33 | if ( $callback ) { |
34 | $callback( $array, $this ); |
35 | } |
36 | return $array; |
37 | } |
38 | } |