contentDisposition function

String contentDisposition(
  1. String name, {
  2. bool inline = false,
})

Content-Disposition by RFC 6266: an ASCII filename for old clients and filename* (RFC 5987) when the name is not plain ASCII. A name with a path or a control character is a programming error, as in Symfony's HeaderUtils::makeDisposition.

Implementation

String contentDisposition(String name, {bool inline = false}) {
  if (name.isEmpty || name.contains(RegExp(r'[/\\\x00-\x1f\x7f]'))) {
    throw ArgumentError.value(name, 'name', 'Not a file name.');
  }
  final kind = inline ? 'inline' : 'attachment';
  final fallback = name
      .replaceAll(RegExp(r'[^\x20-\x7e]'), '_')
      .replaceAll('%', '_')
      .replaceAllMapped(RegExp(r'["\\]'), (match) => '\\${match[0]}');
  final plain = RegExp(r'^[\x20-\x7e]*$').hasMatch(name) && !name.contains('%');
  if (plain) {
    return '$kind; filename="$fallback"';
  }
  return "$kind; filename=\"$fallback\"; filename*=UTF-8''${_extValue(name)}";
}