*/
public static function provideMaliciousHtml(): Traversable {
yield 'script tag' => ['Hello', '">click', 'href="data:'];
yield 'data:text/html URL in iframe' => ['', 'src="data:'];
yield 'data:text/html URL in image' => ['
', 'src="data:'];
yield 'data:image URL in link' => ['click', 'href="data:'];
}
public static function test_sanitizeHTML_whenSafeHtml_keepsAllowedTags(): void {
$result = FreshRSS_SimplePieCustom::sanitizeHTML('
Hello world
');
self::assertSame('Hello world
', $result);
}
public static function test_sanitizeHTML_whenUnsafeAttributeIsRemoved_keepsAllowedTag(): void {
self::assertSame('Hello
', FreshRSS_SimplePieCustom::sanitizeHTML('Hello
'));
self::assertSame('Hello
', FreshRSS_SimplePieCustom::sanitizeHTML('Hello
', maxLength: 100));
}
public static function test_sanitizeHTML_whenMaxLengthIsZeroOrNegative_returnsEmptyString(): void {
self::assertSame('', FreshRSS_SimplePieCustom::sanitizeHTML('Hello world
', maxLength: 0));
self::assertSame('', FreshRSS_SimplePieCustom::sanitizeHTML('Hello world
', maxLength: -1));
}
public static function test_sanitizeHTML_whenResultFitsWithinMaxLength_isUnaffected(): void {
$result = FreshRSS_SimplePieCustom::sanitizeHTML('Hello world
', maxLength: 100);
self::assertSame('Hello world
', $result);
}
public static function test_sanitizeHTML_whenUnsafePrefixExceedsMaxLength_keepsSafeText(): void {
self::assertSame('text', FreshRSS_SimplePieCustom::sanitizeHTML('text', maxLength: 5));
}
/**
* Sanitizing can grow a truncated fragment (e.g. `
He` gets sanitized into `
He
`)
*/
#[DataProvider('provideMaxLengthInputs')]
public static function test_sanitizeHTML_whenMaxLengthForcesReSanitizing_terminatesWithinBound(string $input, int $maxLength): void {
$result = FreshRSS_SimplePieCustom::sanitizeHTML($input, maxLength: $maxLength);
self::assertLessThanOrEqual($maxLength, strlen($result));
}
/** @return Traversable */
public static function provideMaxLengthInputs(): Traversable {
yield 'unclosed tag' => ['Hello world
', 5];
yield 'repeated short tags' => [str_repeat('x ', 50), 20];
yield 'single-character budget' => ['Hello world
', 1];
}
#[DataProvider('provideIncompleteTagsOrEntities')]
public static function test_sanitizeHTML_Cases(string $input, int $maxLength, string $expected): void {
$result = FreshRSS_SimplePieCustom::sanitizeHTML($input, maxLength: $maxLength);
self::assertLessThanOrEqual($maxLength, strlen($result));
self::assertSame(trim($expected), trim($result));
}
/** @return Traversable */
public static function provideIncompleteTagsOrEntities(): Traversable {
yield 'unclosed tag not fitting' => ['Hello World', 31, 'Hello'];
yield 'unclosed entity' => ['Hello…', 9, 'Hello'];
yield 'double unclosed tag' => [' x', 10, 'x'];
yield 'triple unclosed tag' => [' y', 20, 'y'];
}
/**
* Inline `data:image/...` URIs are inert in `
` and widely used by feeds, so they must survive
* while `data:` is blocked on navigational/framing attributes (see provideMaliciousHtml()).
*/
public static function test_sanitizeHTML_whenDataImageUri_keepsItOnImageElements(): void {
$png = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';
self::assertSame('
', FreshRSS_SimplePieCustom::sanitizeHTML('
'));
self::assertStringContainsString('poster="' . $png . '"', FreshRSS_SimplePieCustom::sanitizeHTML(''));
}
public static function test_sanitizeHTML_whenDisallowedScheme_prefixesUnsafe(): void {
$result = FreshRSS_SimplePieCustom::sanitizeHTML('click');
self::assertStringContainsString('href="unsafe:data:text/html,x"', $result);
}
/**
* Test malformed HTML.
* Legacy `DOMDocument` cannot properly handle some unclosed tags,
* but PHP 8.4+ native `Dom\HTMLDocument` parser can.
*/
#[DataProvider('provideUnclosedDivInListItem')]
public static function test_sanitizeHTML_whenUnclosedDivInListItem_keepsListItemsAsSiblings(string $input, string $listTag): void {
if (PHP_VERSION_ID < 80400 || get_parent_class(\Dom\HTMLDocument::class) === \DOMDocument::class) {
self::markTestSkipped('Requires the HTML5 parser of a native `Dom\HTMLDocument` (PHP 8.4+)');
}
$sanitized = FreshRSS_SimplePieCustom::sanitizeHTML($input);
// Embed the result in a minimal page-like context to detect stray closing tags.
// Fragment of a page, so prefix with ``
$document = \Dom\HTMLDocument::createFromString(
'',
\Dom\HTML_NO_DEFAULT_NS);
$list = $document->querySelector($listTag);
self::assertNotNull($list, 'The list wrapper must be preserved');
$listItems = 0;
foreach ($list->childNodes as $child) {
if ($child instanceof \Dom\Element && $child->localName === 'li') {
$listItems++;
}
}
self::assertSame(2, $listItems, 'Both list items must be direct children of their list');
$mark = $document->querySelector('#fragmark');
self::assertInstanceOf(\Dom\Element::class, $mark);
$markParent = $mark->parentNode;
self::assertInstanceOf(\Dom\Element::class, $markParent);
self::assertSame('box', $markParent->getAttribute('class'), 'The content after the fragment must stay inside its page container');
}
/** @return Traversable */
public static function provideUnclosedDivInListItem(): Traversable {
yield 'Footnote list' => [<<<'HTML'
In the end.